OID_SWITCH_PROPERTY_ENUM
La extensión de conmutador extensible de Hyper-V emite una solicitud de método de identificador de objeto (OID) de OID_SWITCH_PROPERTY_ENUM para obtener una matriz. Esta matriz contiene las directivas de conmutador aprovisionadas que coinciden con los criterios especificados. Cada elemento de la matriz especifica las propiedades de una directiva de conmutador extensible.
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_PROPERTY_ENUM_PARAMETERS que especifica los parámetros de la enumeración de directivas de conmutador extensible.
Matriz de estructuras de NDIS_SWITCH_PROPERTY_ENUM_INFO . Cada una de estas estructuras contiene información sobre una directiva de conmutador extensible.
Nota Si la extensión no se ha aprovisionado con instancias de la directiva de conmutador extensible especificada, la extensión establece el miembro NumProperties de la estructura de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS en cero y no se devuelve ninguna estructura NDIS_SWITCH_PROPERTY_ENUM_INFO .
Observaciones
El OID_SWITCH_PROPERTY_ENUM OID 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.
A diferencia de las solicitudes de consulta de OID de OID_SWITCH_PORT_PROPERTY_ENUM, la extensión no tiene que llamar a ninguna función ReferenceSwitchXxx o DereferenceSwitchXxx cuando emite la OID_SWITCH_PROPERTY_ENUM solicitar la pila de controladores de conmutador extensible.
Nota Si la extensión recibe la solicitud de método OID de OID_SWITCH_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_PROPERTY_ENUM y devuelve uno de los siguientes códigos de estado.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud de OID se completó correctamente. |
NDIS_STATUS_INVALID_LENGTH |
La longitud del búfer de información es demasiado pequeña para devolver la estructura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS y su matriz de elementos NDIS_SWITCH_PROPERTY_ENUM_INFO . El borde de minipuerto subyacente del conmutador extensible establece data . METHOD_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario. |
NDIS_STATUS_FAILURE |
Error en la solicitud por otros motivos. |
Requisitos
Versión |
Se admite en NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |
Consulte también
NDIS_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Consulta de la configuración del conmutador extensible de Hyper-V