OID_SWITCH_NIC_SAVE

El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de método de identificador de objeto (OID) de OID_SWITCH_NIC_SAVE durante una operación para ahorrar datos en tiempo de ejecución para un puerto de conmutador extensible y su conexión de adaptador de red. La extensión devuelve estos datos para que los datos en tiempo de ejecución se puedan guardar y restaurar más adelante. Una vez guardados los datos en tiempo de ejecución, se restaura a través de solicitudes de conjunto de OID de OID_SWITCH_NIC_RESTORE.

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 método OID de OID_SWITCH_NIC_SAVE, la extensión de conmutador extensible guarda los datos en tiempo de ejecución haciendo lo siguiente:

• La extensión guarda los datos dentro de la estructura de NDIS_SWITCH_NIC_SAVE_STATE a partir de bytes SaveDataOffset desde el principio de la estructura.

• Si saveDataSize proporcionado no es lo suficientemente grande como para contener los datos de guardado necesarios, la extensión establece el campo BytesNeededed de la estructura del método en NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 más la cantidad de búfer necesario para contener los datos guardados y completa el OID con NDIS_STATUS_BUFFER_TOO_SHORT. El OID se volverá a emitir con el tamaño necesario.

• La extensión rellena los campos ExtensionId y ExtensionFriendlyName con su propio identificador y nombre, y completa la solicitud del método OID con NDIS_STATUS_SUCCESS. Esto hace que el borde del protocolo del conmutador extensible emita otra solicitud de método OID para permitir que la extensión devuelva más datos de guardado o permitir que otras extensiones de la pila guarden sus propios datos.

Nota Si la extensión no tiene datos en tiempo de ejecución para guardar, debe llamar a NdisFOidRequest para reenviar esta solicitud de método OID a las extensiones subyacentes en la pila de controladores de conmutador extensible. Para obtener más información sobre este procedimiento, consulte Filtrado de solicitudes de OID en un controlador de filtro NDIS.

El conmutador extensible de Hyper-V rellena los campos Header, PortId, NicIdex, SaveDataSize y SaveDataOffset de la estructura antes de emitir el OID. La extensión no puede modificar estos campos.

Las solicitudes de método OID de OID_SWITCH_NIC_SAVE se controlan en última instancia mediante el borde miniporte subyacente del conmutador extensible. Una vez recibida esta solicitud de método OID, el minipuerto del conmutador extensible completa la solicitud OID con NDIS_STATUS_SUCCESS. Esto notifica al borde del protocolo del conmutador extensible que se han consultado todas las extensiones de la pila del controlador de conmutador extensible para los datos en tiempo de ejecución. A continuación, el borde del protocolo del conmutador extensible emite una solicitud de conjunto de OID de OID_SWITCH_NIC_SAVE_COMPLETE para completar la operación de guardado.

Para obtener más información sobre cómo guardar datos en tiempo de ejecución para un puerto de conmutador extensible, vea Guardar conmutador extensible de Hyper-V Run-Time datos.

Códigos de estado de devolución

La extensión de conmutador extensible devuelve uno de los siguientes códigos de estado para la solicitud de método OID de OID_SWITCH_NIC_SAVE.

El borde miniporte subyacente del conmutador extensible devuelve el siguiente código de estado para la solicitud de método OID de OID_SWITCH_NIC_SAVE.

Requisitos

Consulte también

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE

NdisFOidRequest

OID_SWITCH_NIC_RESTORE

OID_SWITCH_NIC_SAVE_COMPLETE