Administración de información de estado de características de conmutador personalizado
La interfaz de conmutador extensible de Hyper-V usa el siguiente identificador de objeto (OID) para consultar la información de estado personalizada del conmutador extensible. Esta información de estado se conoce como información de estado de la característica switch :
OID_SWITCH_FEATURE_STATUS_QUERY
El borde del protocolo del conmutador extensible emite esta solicitud de método OID para obtener la información de estado de la característica personalizada para una propiedad de conmutador especificada.
Después de una devolución correcta de esta solicitud de método OID, 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_FEATURE_STATUS_PARAMETERS que especifica la información de estado de la característica personalizada que se va a devolver.
Nota Para un estado de característica personalizado, el miembro FeatureStatusType se establece en NdisSwitchPropertyTypeCustom.
Estructura NDIS_SWITCH_FEATURE_STATUS_CUSTOM que contiene la información de estado sobre una propiedad personalizada asignada a un puerto de conmutador extensible.
Cuando el borde del protocolo del conmutador extensible emite la solicitud de OID_SWITCH_FEATURE_STATUS_QUERY , establece los miembros FeatureStatusCustomBufferLength y FeatureStatusCustomBufferOffset en una ubicación del miembro InformationBuffer que la extensión puede usar para devolver la información de estado de la característica.
La extensión de conmutador extensible debe seguir estas instrucciones cuando recibe una solicitud de método OID de OID_SWITCH_FEATURE_STATUS_QUERY:
La extensión debe controlar la solicitud OID si administra un estado de característica de conmutador extensible personalizado que coincide con el miembro FeatureStatusId de la estructura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS .
Si la extensión controla la solicitud de método OID, debe devolver la información de estado de la característica que coincida con los parámetros especificados por la estructura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS .
Si el búfer de estado de la característica es demasiado pequeño, la extensión debe producir un error en la solicitud de OID con NDIS_STATUS_INVALID_LENGTH. La extensión debe establecer data . SET_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
De lo contrario, la extensión debe devolver la información de estado de la característica y completar la solicitud de OID con NDIS_STATUS_SUCCESS.
Si la extensión no administra el estado de la característica de conmutador extensible personalizado, debe llamar a NdisFOidRequest para reenviar la solicitud de OID a la pila de controladores de conmutador extensible.
Para obtener más información sobre cómo reenviar solicitudes de OID, consulte Filtrado de solicitudes de OID en un controlador de filtro NDIS.
Para obtener más información sobre cómo definir y registrar la información sobre el estado de las características del conmutador, consulte Custom Switch Feature Status.