Administración de información de estado de características de puerto personalizado
La interfaz del conmutador extensible de Hyper-V usa el siguiente identificador de objeto (OID) para consultar información de estado personalizada para un puerto de conmutador extensible. Esta información de estado se conoce como información de estado de la característica de puerto :
OID_SWITCH_PORT_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 puerto 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 siguientes datos:
Estructura NDIS_SWITCH_PORT_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 NdisSwitchPortPropertyTypeCustom.
Estructura NDIS_SWITCH_PORT_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_PORT_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 directrices cuando recibe una solicitud de método OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY:
La extensión debe controlar la solicitud OID si administra una propiedad de puerto de conmutador extensible personalizada que coincida con el miembro FeatureStatusId de la estructura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS .
Si la extensión controla la solicitud del método OID, debe devolver la información de estado de la característica que coincida con los parámetros especificados por la estructura de NDIS_SWITCH_PORT_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. BytesNeeded miembro 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 OID con NDIS_STATUS_SUCCESS.
Si la extensión no administra la propiedad de conmutador extensible personalizada, debe llamar a NdisFOidRequest para reenviar la solicitud 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 OID en un controlador de filtro NDIS.
Para obtener más información sobre cómo definir y registrar información sobre el estado de la característica de puerto, consulte Estado de característica de puerto personalizado.