OID_SWITCH_NIC_DELETE
El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_DELETE a la pila extensible del controlador del conmutador. Esta solicitud de OID notifica a las extensiones de conmutador extensible subyacentes 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 miembro PortId 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ámetros de este y otros puertos en el conmutador extensible mediante la emisión de solicitudes de consulta OID de OID_SWITCH_PORT_ARRAY.
El miembro Index 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 de Índice especificado está conectado al puerto de conmutador extensible especificado por el miembro PortId . Para obtener más información sobre estos valores de índice, consulte 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 hayan completado todas las solicitudes de OID pendientes para la conexión del adaptador y que los contadores de referencia de conmutador extensible para la conexión del adaptador tengan 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 el contador de referencia es distinto de 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 de conjunto de OID de OID_SWITCH_NIC_DELETE:
La extensión no debe modificar la estructura de NDIS_SWITCH_NIC_PARAMETERS asociada a la solicitud OID.
La extensión siempre debe reenviar esta solicitud de establecimiento 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 de 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 del adaptador de red diferente. Para obtener más información sobre estos valores de índice, consulte 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 se pueden enlazar adaptadores de red físicos al adaptador de red externo, vea Tipos de configuraciones de adaptador de red física.
Para obtener más información sobre los estados de los puertos de conmutador extensibles y las conexiones del adaptador de red, consulte Puerto de conmutador extensible de Hyper-V y Estados del adaptador de red.
Códigos de estado de devolución
El borde de minipuerto subyacente del conmutador extensible completa la solicitud de consulta OID de OID_SWITCH_NIC_DELETE y devuelve el código de estado siguiente.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud de OID se completó correctamente. |
Requisitos
Versión |
Se admite en NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |