The protocol edge of the Hyper-V extensible switch issues an object identifier (OID) set request of OID_SWITCH_NIC_RESTORE to notify the extensible switch extension about run-time data that can be restored for an extensible switch port and its network adapter connection.
The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_SWITCH_NIC_SAVE_STATE structure. This structure is allocated by the protocol edge of the extensible switch.
When it receives the OID set request of OID_SWITCH_NIC_RESTORE, the extensible switch extension must first determine whether it owns the run-time data. The extension does this by comparing the value of the ExtensionId member of the NDIS_SWITCH_NIC_SAVE_STATE structure to the GUID value that the extension uses to identify itself.
If the extension owns the run-time data for an extensible switch port, it restores this data in the following way:
The extension copies the run-time data in the SaveData member to extension-allocated storage.Note The value of the PortId member of the NDIS_SWITCH_NIC_SAVE_STATE structure may be different from the PortId value at the time that the run-time data was saved. This can occur if run-time data was saved during a Live Migration from one host to another. However, the configuration of the extensible switch port is retained during the Live Migration. This enables the extension to restore the run-time data to the extensible switch port by using the new PortId value.
- The extension completes the OID set request with NDIS_STATUS_SUCCESS.
If the extension does not own the specified run-time data, the extension calls NdisFOidRequest to forward this OID set request to underlying extensions in the extensible switch driver stack. In this case, the extension must not modify the NDIS_SWITCH_NIC_SAVE_STATE structure that is associated with the OID request.
If the OID_SWITCH_NIC_RESTORE set request is received by the miniport edge of the extensible switch, it completes the OID request with NDIS_STATUS_SUCCESS. This notifies the protocol edge of the extensible switch that no extension owns the run-time data.
For more information about how to restore run-time data, see Restoring Hyper-V Extensible Switch Run-Time Data.
If the extension completes the OID set request of OID_SWITCH_NIC_RESTORE, it returns one of the following status codes.
The OID request completed successfully.
The request failed for other reasons.
|Supported in NDIS 6.30 and later.|