OID_NIC_SWITCH_DELETE_SWITCH

Artículo
06/15/2023

NDIS emite una solicitud de conjunto de identificador de objeto (OID) de OID_NIC_SWITCH_DELETE_SWITCH para eliminar un conmutador NIC de un adaptador de red.

NDIS emite esta solicitud de conjunto de OID al controlador de minipuerto de la función física (PF) del adaptador de red PCI Express (PCIe). 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).

Nota Los controladores que se sobreponen, como los controladores de protocolo o de filtro, no pueden emitir esta solicitud de método OID al controlador de miniporte PF.

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

Observaciones

Una solicitud de conjunto de OID de OID_NIC_SWITCH_DELETE_SWITCH elimina un conmutador NIC que se creó anteriormente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_SWITCH.

Cuando recibe la solicitud de método OID de OID_NIC_SWITCH_DELETE_SWITCH, el controlador de miniporte PF debe hacer lo siguiente:

Si el controlador de miniporte PF admite la creación estática y la configuración de conmutadores NIC, debe liberar los recursos de software asociados con el conmutador NIC especificado. Sin embargo, el controlador solo puede liberar los recursos de hardware para el conmutador NIC cuando se llama a MiniportHaltEx .

Para obtener más información sobre la creación de conmutadores NIC estáticos, consulte Creación estática de un conmutador NIC.
Si el controlador de miniporte PF admite la creación dinámica y la configuración de conmutadores NIC, debe liberar los recursos de hardware y software asociados al conmutador NIC especificado.

Para obtener más información sobre la creación dinámica de conmutadores NIC, consulte Creación dinámica de un conmutador NIC.
Si el controlador de miniporte PF admite la creación dinámica y se han eliminado todos los conmutadores NIC, el controlador debe deshabilitar la virtualización en el adaptador llamando a NdisMEnableVirtualization. Para deshabilitar la virtualización, el adaptador de red debe establecer el parámetro EnableVirtualization en FALSE y el parámetro NumVFs en cero.

NdisMEnableVirtualization borra el miembro NumVFs y el bit Enable VF en la estructura de funcionalidad extendida SR-IOV en el espacio de configuración PCI del PF del adaptador de red.

Nota Si el controlador de miniporte PF admite la creación estática y la configuración de conmutadores NIC, solo debe llamar a NdisMEnableVirtualization cuando se llama a MiniportHaltEx .

Para obtener más información, consulte Eliminación de un conmutador NIC.

Códigos de estado de devolución

La función MiniportOidRequest del controlador miniportador devuelve uno de los siguientes valores para esta solicitud:

Término	Descripción
NDIS_STATUS_SUCCESS	El controlador de minipuerto completó la solicitud correctamente.
NDIS_STATUS_PENDING	El controlador de minipuerto completará la solicitud de forma asincrónica. Después de que el controlador de miniporte haya completado todo el procesamiento, debe realizarse correctamente la solicitud llamando a la función NdisMOidRequestComplete , pasando NDIS_STATUS_SUCCESS para el parámetro Status .
NDIS_STATUS_NOT_ACCEPTED	El controlador de minipuerto se está restableciendo.
NDIS_STATUS_REQUEST_ABORTED	El controlador de minipuerto detuvo el procesamiento de la solicitud. Por ejemplo, NDIS llamó a la función MiniportResetEx .

NDIS devuelve uno de los siguientes códigos de estado para esta solicitud:

Término	Descripción
NDIS_STATUS_SUCCESS	La solicitud OID se completó correctamente.
NDIS_STATUS_NOT_SUPPORTED	El controlador de miniporte PF no admite la interfaz SR-IOV o no está habilitado para usar la interfaz .
NDIS_STATUS_FILE_NOT_FOUND	Uno o varios de los miembros de la estructura NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS tienen valores no válidos.
NDIS_STATUS_INVALID_LENGTH	El búfer de información es demasiado pequeño. NDIS establece data . SET_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.