OID_SWITCH_NIC_UPDATED

The protocol edge of the Hyper-V extensible switch issues an object identifier (OID) set request of OID_SWITCH_NIC_UPDATED to the extensible switch driver stack. This OID request notifies underlying extensible switch extensions about the update of the parameters of a network adapter. The OID will only be issued for NICs that have already been connected, and have not yet begun the disconnect process. These run-time configuration changes can include NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress, and VFAssigned.

The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_SWITCH_NIC_PARAMETERS structure.

Remarks

The PortId member of the NDIS_SWITCH_NIC_PARAMETERS structure specifies the port for which the update notification is being made. The extensible switch extension can obtain the parameter information for this and other ports on the extensible switch by issuing OID query requests of OID_SWITCH_PORT_ARRAY.

The Index member of the NDIS_SWITCH_NIC_PARAMETERS structure specifies the index of a network adapter for which the update notification is being made. The network adapter with the specified Index value is connected to the extensible switch port specified by the PortId member. For more information on these index values, see Network Adapter Index Values.

The extension must follow these guidelines for handling OID set requests of OID_SWITCH_NIC_UPDATED:

  • The extension must not modify the NDIS_SWITCH_NIC_PARAMETERS structure that is associated with the OID request.
  • The extension must always forward this OID set request to underlying extensions. The extension must not complete the request.
  • The extension must not issue its own OID set requests of OID_SWITCH_NIC_UPDATED.

Return Status Codes

The underlying miniport edge of the extensible switch completes the OID query request of OID_SWITCH_NIC_UPDATED and returns the following status code.

Status CodeDescription

NDIS_STATUS_SUCCESS

The OID request completed successfully.

 

Requirements

Version

Supported in NDIS 6.30 and later.

Header

Ntddndis.h (include Ndis.h)

See also

DereferenceSwitchNic
NDIS_OID_REQUEST
NDIS_SWITCH_NIC_PARAMETERS
OID_SWITCH_NIC_DISCONNECT
OID_SWITCH_PORT_ARRAY
ReferenceSwitchNic

 

 

Send comments about this topic to Microsoft

Anzeigen:
© 2015 Microsoft