OID_SWITCH_PORT_CREATE

El borde del protocolo del Hyper-V conmutador extensible emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_PORT_CREATE para notificar a las extensiones de conmutador extensible sobre la creación de un puerto de conmutador extensible.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SWITCH_PORT_PARAMETERS.

Observaciones

El portId miembro de la estructura NDIS_SWITCH_PORT_PARAMETERS especifica el puerto para el que se realiza la notificación de creación.

La extensión de conmutador extensible debe seguir estas instrucciones para controlar las solicitudes del conjunto de OID de OID_SWITCH_PORT_CREATE:

• La extensión no debe modificar la estructura NDIS_SWITCH_PORT_PARAMETERS asociada a la solicitud OID.

• La extensión puede vetar la notificación de creación 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, el controlador debe vetar la notificación de creación.

  Si la extensión devuelve otros NDIS_STATUS_códigos de estado de error xxx, la notificación de creación también se veta. 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 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 más información sobre las directivas de puerto, consulte Administración de directivas de conmutador extensible de Hyper-V.

• Si la extensión llama a NdisFOidRequest para reenviar esta solicitud de conjunto de OID, la extensión debe supervisar el estado de finalización de esta solicitud OID. La extensión lo hace para detectar si las extensiones subyacentes de la pila del controlador de conmutador extensible han vetado la notificación de creación del puerto.

• Una vez reenviada la solicitud OID y se completa correctamente, la extensión puede emitir solicitudes de OID para el puerto, como OID_SWITCH_PORT_PROPERTY_ENUM, hasta que se emita una solicitud OID de OID_SWITCH_PORT_TEARDOWN. Esta solicitud de OID notifica a la extensión que el puerto iniciará el proceso de eliminación del conmutador extensible.

• Las extensiones no pueden reenviar paquetes al puerto especificado en la estructura de NDIS_SWITCH_PORT_PARAMETERS hasta que se emita una solicitud de conjunto de OID de OID_SWITCH_NIC_CONNECT y se complete correctamente.

Nota Extensiones no deben emitir solicitudes de conjunto de OID de OID_SWITCH_PORT_CREATE.

Para obtener más información sobre los estados de los puertos de conmutador extensible y las conexiones del adaptador de red, consulte Hyper-V Los estados del adaptador de red y el puerto de conmutador extensible.

Códigos de estado de retorno

Si la extensión completa la solicitud de conjunto de OID de OID_SWITCH_PORT_CREATE, devuelve uno de los siguientes códigos de estado.

Nota Si la extensión completa la solicitud de conjunto de OID, no debe devolver NDIS_STATUS_SUCCESS.

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

Requisitos

Consulte también

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_PROPERTY_ENUM