OID_SWITCH_PROPERTY_UPDATE
El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_PROPERTY_UPDATE para notificar a las extensiones de conmutador extensible sobre la actualización a los parámetros de una propiedad de 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 siguientes datos:
Estructura NDIS_SWITCH_PROPERTY_PARAMETERS que especifica la identificación y el tipo de una directiva de conmutador extensible.
Búfer de propiedades que contiene los parámetros de una directiva de conmutador extensible. El búfer de propiedades contiene una estructura basada en el miembro PropertyType de la estructura NDIS_SWITCH_PROPERTY_PARAMETERS .
Nota A partir de Windows Server 2012, el miembro PropertyType debe establecerse en NdisSwitchPropertyTypeCustom y el búfer de propiedades debe contener una estructura NDIS_SWITCH_PROPERTY_CUSTOM.
Observaciones
Una extensión de reenvío puede controlar la solicitud de conjunto de OID de OID_SWITCH_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 switch 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 conmutador, 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 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 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_PROPERTY_UPDATE, consulte Administración de directivas de conmutador.
Códigos de estado de devolución
Si la extensión completa la solicitud de conjunto de OID de OID_SWITCH_PROPERTY_UPDATE, devuelve uno de los siguientes códigos de estado.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
La extensión ha vetado la notificación de actualización de la directiva switch. |
NDIS_STATUS_FAILURE |
Error en la solicitud OID por otros motivos. |
Si la extensión no completa la solicitud de conjunto de OID de OID_SWITCH_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.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud OID se completó correctamente. |
Requisitos
Versión |
Compatible con NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |