OID_SWITCH_PORT_UPDATED
The protocol edge of the Hyper-V extensible switch issues an object identifier (OID) set request of OID_SWITCH_PORT_UPDATED to notify extensible switch extensions about the update of an extensible switch port. The OID will only be issued for ports that have already been created, and have not yet begun the teardown/delete process. Currently, only the PortFriendlyName field is subject to update after creation.
The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_SWITCH_NIC_SAVE_STATE structure.
Remarks
The PortId member of the NDIS_SWITCH_PORT_PARAMETERS structure specifies the extensible switch port for which the update notification is being made.
The extension must follow these guidelines for handling OID set requests of OID_SWITCH_PORT_UPDATED:
The extension must not modify the NDIS_SWITCH_PORT_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 fail the request.
Note Extensible switch extensions must not issue OID set requests of OID_SWITCH_PORT_UPDATED.
For more information about the states of extensible switch ports and network adapter connections, see Hyper-V Extensible Switch Port and Network Adapter States.
Return Status Codes
The underlying miniport edge of the extensible switch completes the OID set request of OID_SWITCH_PORT_UPDATED and returns the following status code.
Status Code | Description |
---|---|
NDIS_STATUS_SUCCESS |
The OID request completed successfully. |
Requirements
Version |
Supported in NDIS 6.30 and later. |
Header |
Ntddndis.h (include Ndis.h) |