OID_NIC_SWITCH_DELETE_VPORT
Un controlador de exceso emite una solicitud de conjunto de identificador de objeto (OID) de OID_NIC_SWITCH_DELETE_VPORT para eliminar un puerto virtual no predeterminado (VPort) que se creó anteriormente en el conmutador NIC de un adaptador de red. El controlador de sobreslización puede eliminar un VPort que ha creado anteriormente solo mediante la emisión de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.
El exceso de controladores emite esta solicitud de conjunto de OID al controlador de minipuerto para la función física PCIe (PF) del adaptador de red. Esta solicitud de conjunto de OID es necesaria para los controladores de miniporte PF que admiten la interfaz de virtualización de E/S raíz única (SR-IOV).
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a la estructura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS .
Observaciones
Un controlador de exceso, como un protocolo o un controlador de filtro, solo puede eliminar una VPort no predeterminada que haya creado anteriormente. El controlador de sobreslización crea una VPort mediante la emisión de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Cuando el controlador de miniporte PF recibe la solicitud OID de OID_NIC_SWITCH_DELETE_VPORT, el controlador debe liberar los recursos de hardware y software que se asignaron para la VPort especificada.
Para más información, consulte Eliminación de un puerto virtual.
Nota Solo las VPorts no predeterminadas se pueden eliminar explícitamente a través de solicitudes de OID de OID_NIC_SWITCH_DELETE_VPORT. El VPort predeterminado se elimina implícitamente cuando el controlador de minipuerto PF elimina el conmutador NIC predeterminado. Para obtener más información, consulte Eliminación de un conmutador NIC.
Códigos de estado de devolución
El controlador de minipuerto PF devuelve uno de los siguientes códigos de estado para la solicitud de conjunto de OID de OID_NIC_SWITCH_DELETE_VPORT.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud OID se completó correctamente. |
NDIS_STATUS_NOT_SUPPORTED |
El controlador de miniporte PF no admite la interfaz de virtualización de E/S raíz única (SR-IOV) o no está habilitada para usar la interfaz. |
NDIS_STATUS_INVALID_PARAMETER |
Uno o varios de los miembros de la estructura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS tienen valores no válidos. |
NDIS_STATUS_INVALID_LENGTH |
La longitud del búfer de información es menor que sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS). El controlador de minipuerto PF debe establecer data . SET_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario. |
NDIS_STATUS_FAILURE |
Error en la solicitud por otros motivos. |
Requisitos
Versión |
Compatible con NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |