OID_SWITCH_PORT_PROPERTY_ENUM

Artículo
06/15/2023

La extensión de conmutador extensible de Hyper-V emite una solicitud de método de identificador de objeto (OID) de OID_SWITCH_PORT_PROPERTY_ENUM para obtener una matriz. Esta matriz contiene las directivas de puerto aprovisionadas que coinciden con los criterios especificados. Cada elemento de la matriz especifica las propiedades de una directiva para un puerto de conmutador extensible especificado.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer contiene los datos siguientes:

Estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS que especifica los parámetros para la enumeración de directivas de un puerto especificado.
Matriz de estructuras de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO . Cada una de estas estructuras contiene información sobre las propiedades de una directiva de puerto de conmutador extensible.

Nota Si el miembro NumProperties de la estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS se establece en cero, no se devuelve ninguna estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Observaciones

Antes de que se produzca una solicitud de método OID de OID_SWITCH_PORT_PROPERTY_ENUM, la extensión de conmutador extensible debe seguir estas instrucciones:

La extensión solo puede emitir la solicitud de OID_SWITCH_PORT_PROPERTY_ENUM después de que el borde del protocolo del conmutador extensible emita una solicitud de OID_SWITCH_PORT_CREATE y antes de que emita una solicitud de OID_SWITCH_PORT_TEARDOWN .
La extensión debe llamar a ReferenceSwitchPort antes de llamar a NdisFOidRequest para emitir la solicitud OID_SWITCH_PORT_PROPERTY_ENUM. Esto garantiza que el puerto especificado no se eliminará hasta que se complete la solicitud de OID.

Una vez completada la solicitud de OID, la extensión debe llamar a DereferenceSwitchPort. La extensión debe llamar a esta función independientemente de si la solicitud de OID se completó con NDIS_STATUS_SUCCESS.

El OID de OID_SWITCH_PORT_PROPERTY_ENUM solo debe emitirse cuando el conmutador extensible de Hyper-V haya completado la activación. Consulte Consulta de la configuración de conmutador extensible de Hyper-V para obtener más detalles.

Nota Si la extensión recibe la solicitud de método OID de OID_SWITCH_PORT_PROPERTY_ENUM, no debe completar la solicitud OID. En su lugar, debe llamar a NdisFOidRequest para reenviar la solicitud de OID a la pila extensible del controlador del conmutador.

Códigos de estado de devolución

El borde de minipuerto subyacente del conmutador extensible completa la solicitud de consulta OID de OID_SWITCH_PORT_PROPERTY_ENUM y devuelve el código de estado siguiente.