OID_SWITCH_PORT_PROPERTY_ADD

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_ADD para notificar a las extensiones de conmutador extensible la adición de una propiedad de directiva para un 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 datos siguientes:

Estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS que especifica la identificación y el tipo de parámetros de una directiva de puerto.
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 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_ADD. Todos los demás tipos de extensiones deben llamar a NdisFOidRequest para reenviar la solicitud OID a la siguiente extensión en la pila extensible del controlador de conmutador.

La extensión puede vetar la adición de la propiedad port devolviendo NDIS_STATUS_DATA_NOT_ACCEPTED para la solicitud OID. Por ejemplo, si una extensión no puede asignar recursos para aplicar sus directivas configuradas en el puerto, debe vetar la solicitud de adició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 creació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 veta la solicitud de OID, debe supervisar el estado cuando se completa la solicitud. La extensión debe hacerlo para determinar si la solicitud de 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_ADD, 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_ADD, 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. Miembro BytesNeeded 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 adició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 de OID por otros motivos.

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