OID_SWITCH_PORT_PROPERTY_ENUM

El Hyper-V extensión de conmutador extensible 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 informationBuffer miembro de la estructura NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer contiene los siguientes datos:

• Estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS que especifica los parámetros de 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 de 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 emite 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 de OID_SWITCH_PORT_PROPERTY_ENUM. Esto garantiza que el puerto especificado no se eliminará hasta que se complete la solicitud OID.

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

El OID_SWITCH_PORT_PROPERTY_ENUM OID solo debe emitirse cuando el conmutador extensible 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 OID a la pila de controladores extensible del conmutador.

Códigos de estado de retorno

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

Requisitos

Consulte también

DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS

NdisFOidRequest

Consulta de la configuración de conmutador extensible de Hyper-V

ReferenceSwitchPort