OID_SWITCH_NIC_RESTORE

Artículo
06/14/2023

El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_RESTORE para notificar a la extensión de conmutador extensible los datos en tiempo de ejecución que se pueden restaurar para un puerto de conmutador extensible y su conexión de adaptador de red.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SWITCH_NIC_SAVE_STATE . Esta estructura se asigna mediante el borde del protocolo del conmutador extensible.

Observaciones

Cuando recibe la solicitud de conjunto de OID de OID_SWITCH_NIC_RESTORE, la extensión de conmutador extensible debe determinar primero si posee los datos en tiempo de ejecución. La extensión lo hace comparando el valor del miembro ExtensionId de la estructura de NDIS_SWITCH_NIC_SAVE_STATE con el valor GUID que usa la extensión para identificarse.

Si la extensión posee los datos en tiempo de ejecución de un puerto de conmutador extensible, restaura estos datos de la siguiente manera:

La extensión copia los datos en tiempo de ejecución del miembro SaveData en el almacenamiento asignado por la extensión.

Nota El valor del miembro PortId de la estructura NDIS_SWITCH_NIC_SAVE_STATE puede ser diferente del valor de PortId en el momento en que se guardaron los datos en tiempo de ejecución. Esto puede ocurrir si los datos en tiempo de ejecución se guardaron durante una migración en vivo de un host a otro. Sin embargo, la configuración del puerto de conmutador extensible se conserva durante la migración en vivo. Esto permite que la extensión restaure los datos en tiempo de ejecución en el puerto de conmutador extensible mediante el nuevo valor PortId .
La extensión completa la solicitud de conjunto de OID con NDIS_STATUS_SUCCESS.

Si la extensión no posee los datos en tiempo de ejecución especificados, la extensión llama a NdisFOidRequest para reenviar esta solicitud de conjunto de OID a extensiones subyacentes en la pila de controladores de conmutador extensible. En este caso, la extensión no debe modificar la estructura NDIS_SWITCH_NIC_SAVE_STATE asociada a la solicitud OID.

Si el borde de miniporte del conmutador extensible recibe la solicitud OID_SWITCH_NIC_RESTORE set, completa la solicitud OID con NDIS_STATUS_SUCCESS. Esto notifica al borde del protocolo del conmutador extensible que ninguna extensión posee los datos en tiempo de ejecución.

Para obtener más información sobre cómo restaurar datos en tiempo de ejecución, vea Restaurar el conmutador extensible de Hyper-V Run-Time datos.

Nota Si la extensión produce un error en la solicitud de conjunto de OID, el conmutador extensible producirá un error en toda la operación de restauración. Como resultado, la extensión debe evitar que se produzca un error en la solicitud OID si es posible. Por ejemplo, si la extensión no puede asignar el recurso necesario para restaurar los datos en tiempo de ejecución, debe producir un error en la solicitud OID si no puede funcionar correctamente sin restaurar los datos en tiempo de ejecución. Sin embargo, si la extensión puede recuperarse de la condición de error, no debe producir un error en la solicitud establecida de OID.