OID_NIC_SWITCH_DELETE_VPORT
Un controlador demasiado excesivo 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 sobreaprovisionamiento 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.
Los controladores excesivos emiten esta solicitud de conjunto de OID al controlador de miniport para la función física PCIe (PF) del adaptador de red. Esta solicitud de conjunto de OID es necesaria para los controladores de miniport 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 sobreaplicado, como un protocolo o un controlador de filtro, solo puede eliminar un VPort no predeterminado que haya creado anteriormente. El controlador de sobreaprovisionamiento crea un 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 asignados para el VPort especificado.
Para obtener más información, consulte Eliminación de un puerto virtual.
Nota Solo se pueden eliminar explícitamente las VPorts no predeterminadas a través de solicitudes OID de OID_NIC_SWITCH_DELETE_VPORT. El VPort predeterminado se elimina implícitamente cuando el controlador de miniport PF elimina el conmutador NIC predeterminado. Para obtener más información, consulte Eliminar un conmutador NIC.
Códigos de estado de retorno
El controlador de miniport 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 miniport 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 el 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) |