OID_SWITCH_PORT_PROPERTY_UPDATE

Artículo
06/15/2023

El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_PORT_PROPERTY_UPDATE para notificar a las extensiones de conmutador extensible la actualización de una propiedad para una directiva de puerto de conmutador extensible.

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_PROPERTY_PARAMETERS que especifica la identificación y el tipo de una propiedad de puerto.
Un búfer de propiedades que contiene los parámetros de una directiva de puerto. El búfer de propiedades contiene una estructura basada en el miembro PropertyType de la estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Por ejemplo, si el miembro PropertyType se establece en NdisSwitchPortPropertyTypeVlan, el búfer de propiedades contiene una estructura de NDIS_SWITCH_PORT_PROPERTY_VLAN .

Observaciones

Una extensión de reenvío puede controlar la solicitud de conjunto de OID de OID_SWITCH_PORT_PROPERTY_UPDATE. Todos los demás tipos de extensiones deben llamar a NdisFOidRequest para reenviar la solicitud OID a la siguiente extensión en la pila de controladores de conmutador extensible.

La extensión puede vetar la actualización de la propiedad de puerto devolviendo NDIS_STATUS_DATA_NOT_ACCEPTED para la solicitud OID. Por ejemplo, si una extensión no puede asignar recursos para aplicar sus directivas actualizadas en el puerto, debe vetar la solicitud de actualización.

Nota Si la extensión devuelve otros códigos de estado de error NDIS_STATUS_Xxx , también se veta la notificación de actualización. Sin embargo, devolver códigos de estado para escenarios transitorios, como devolver NDIS_STATUS_RESOURCES, podría dar lugar a un reintento de la notificación de creación.

Si la extensión no ve la solicitud de OID, debe supervisar el estado cuando se complete la solicitud. La extensión debe hacerlo para determinar si la solicitud OID fue vetado por extensiones subyacentes en la ruta de acceso de control de conmutador extensible o por la interfaz de conmutador extensible.

Para obtener instrucciones sobre cómo controlar una solicitud de conjunto de OID de OID_SWITCH_PORT_PROPERTY_UPDATE, consulte Administración de directivas de puerto.

Códigos de estado de devolución

Si la extensión de reenvío completa la solicitud de conjunto de OID de OID_SWITCH_PORT_PROPERTY_UPDATE, devuelve uno de los siguientes códigos de estado.

Código de estado	Descripción
NDIS_STATUS_INVALID_LENGTH	La longitud del búfer de información es demasiado pequeña para procesar la estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS y los datos del búfer de propiedades de la estructura. La extensión establece data . SET_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_DATA_NOT_ACCEPTED	La extensión de reenvío ha vetado la notificación de eliminación de la directiva de puerto.
NDIS_STATUS_NOT_SUPPORTED	La extensión de reenvío no admite la directiva de puerto.
NDIS_STATUS_Xxx	Error en la solicitud OID por otros motivos.

Si la extensión no completa la solicitud de conjunto de OID de OID_SWITCH_PORT_PROPERTY_UPDATE, la solicitud se completa mediante el borde miniporte subyacente del conmutador extensible. El borde de minipuerto devuelve el código de estado siguiente.