OID_SWITCH_NIC_DELETE
El borde del protocolo del Hyper-V conmutador extensible emite una solicitud establecida de identificador de objeto (OID) de OID_SWITCH_NIC_DELETE a la pila de controladores de conmutador extensible. Esta solicitud de OID notifica a las extensiones de conmutador extensible subyacentes sobre la eliminación de una conexión entre un puerto de conmutador extensible y un adaptador de red. El borde del protocolo del conmutador extensible notificó previamente que esta conexión se está eliminando cuando emitió una solicitud de conjunto de OID de OID_SWITCH_NIC_DISCONNECT.
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SWITCH_NIC_PARAMETERS.
Observaciones
El portId miembro de la estructura NDIS_SWITCH_NIC_PARAMETERS especifica el puerto para el que se realiza la notificación de eliminación. La extensión de conmutador extensible puede obtener la información de parámetro para este y otros puertos en el conmutador extensible mediante la emisión de solicitudes de consulta OID de OID_SWITCH_PORT_ARRAY.
El index miembro de la estructura NDIS_SWITCH_NIC_PARAMETERS especifica el índice de un adaptador de red para el que se realiza la notificación de eliminación. El adaptador de red con el valor especificado Index está conectado al puerto de conmutador extensible especificado por el miembro PortId. Para obtener más información sobre estos valores de índice, vea valores de índice del adaptador de red.
Antes de que el borde del protocolo del conmutador extensible emite la solicitud de OID_SWITCH_NIC_DELETE, garantiza que se hayan completado todas las solicitudes de paquete de envío o recepción pendientes para la conexión del adaptador de red especificada. El borde del protocolo también garantiza que se han completado todas las solicitudes OID pendientes para la conexión del adaptador y que los contadores de referencia de conmutador extensible para la conexión del adaptador tienen un valor cero.
Nota Si la extensión había incrementado un contador de referencia de conmutador extensible para el adaptador de red llamando a ReferenceSwitchNic, la solicitud de OID_SWITCH_NIC_DELETE no se emite mientras que el contador de referencia no es cero. La extensión disminuye el contador de referencia de conmutador extensible llamando a DereferenceSwitchNic.
La extensión debe seguir estas instrucciones para controlar las solicitudes del conjunto de OID de OID_SWITCH_NIC_DELETE:
La extensión no debe modificar la estructura NDIS_SWITCH_NIC_PARAMETERS asociada a la solicitud OID.
La extensión siempre debe reenviar esta solicitud de conjunto de OID a las extensiones subyacentes. La extensión no debe completar la solicitud.
La extensión no debe emitir sus propias solicitudes de conjunto de OID de OID_SWITCH_NIC_DELETE.
El adaptador de red externo del conmutador extensible puede enlazarse a uno o varios adaptadores físicos subyacentes. Para cada adaptador de red físico enlazado al adaptador de red externo, el borde del protocolo del conmutador extensible emite una solicitud de conjunto de OID independiente de OID_SWITCH_NIC_DELETE. Cada solicitud de conjunto de OID especifica un valor de índice de conexión de adaptador de red diferente. Para obtener más información sobre estos valores de índice, vea valores de índice del adaptador de red.
La extensión debe mantener el estado de conexión para cada adaptador físico subyacente. Para obtener más información sobre las distintas configuraciones en las que los adaptadores de red físicos se pueden enlazar al adaptador de red externo, consulte Tipos de configuraciones de adaptadores de red físicos.
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
El borde de minipuerto subyacente del conmutador extensible completa la solicitud de consulta OID de OID_SWITCH_NIC_DELETE y devuelve el siguiente código de estado.
| 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) |