OID_NIC_SWITCH_CREATE_SWITCH

Artículo
06/15/2023

NDIS emite una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_CREATE_SWITCH para crear un conmutador NIC en un adaptador de red. Cuando controla esta solicitud de OID, el controlador de minipuerto asigna los recursos para el conmutador NIC en el adaptador.

NDIS emite esta solicitud de método de OID al controlador de minipuerto de la función física PCI Express (PCIe) del adaptador de red (PF). Esta solicitud de método OID es necesaria para los controladores de minipuerto 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 filtro, no pueden emitir solicitudes de método OID de OID_NIC_SWITCH_CREATE_SWITCH al controlador de miniporte PF.

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

Observaciones

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

Si el controlador de minipuerto PF admite la creación y configuración de conmutadores estáticos, crea el conmutador NIC cuando NDIS llama a MiniportInitializeEx. Cuando el controlador controla esta solicitud de OID, debe comprobar los parámetros de configuración de la estructura NDIS_NIC_SWITCH_PARAMETERS . Los parámetros deben ser los mismos que los usados por el controlador para crear el modificador durante la llamada a MiniportInitializeEx. Si esto no es cierto, el controlador debe producir un error en la solicitud de OID.

Para obtener más información, vea Creación estática de un conmutador NIC.
Si el controlador de miniporte PF admite la creación y configuración dinámicas de conmutadores, el controlador debe validar los valores de configuración de la estructura de NDIS_NIC_SWITCH_PARAMETERS y crear el conmutador NIC en función de estos valores.

Para obtener más información, vea Creación dinámica de un conmutador NIC.
El controlador de minipuerto PF debe asignar los recursos de hardware y software necesarios para el VPort predeterminado en el conmutador NIC.

Nota El VPort predeterminado siempre se crea a través de una solicitud de OID de OID_NIC_SWITCH_CREATE_SWITCH y se elimina a través de una solicitud de OID de OID_NIC_SWITCH_DELETE_SWITCH. Las solicitudes de OID de OID_NIC_SWITCH_CREATE_VPORT y OID_NIC_SWITCH_DELETE_VPORT se usan para la creación y eliminación de VPorts no predeterminados en el conmutador NIC.
El controlador de minipuerto PF que admite la creación y configuración dinámicas de conmutadores debe habilitar la virtualización SR-IOV en el conmutador mediante una llamada a NdisMEnableVirtualization. Esta llamada configura el miembro NumVFs y el bit Enable de VF en la estructura de funcionalidad extendida SR-IOV del espacio de configuración pci Express (PCIe) del adaptador.

Para obtener más información sobre el espacio de configuración sr-IOV, consulte la especificación virtualización de E/S de raíz única PCI-SIG y uso compartido 1.1 .

Nota Si el controlador de minipuerto PF admite la creación de conmutadores estáticos, habilita la virtualización SR-IOV después de crear el conmutador cuando se llama a MiniportInitializeEx .

Si el controlador de minipuerto PF completa correctamente la solicitud de método OID de OID_NIC_SWITCH_CREATE_SWITCH, permite que se produzca lo siguiente:

Las máquinas virtuales se pueden asignar en el conmutador NIC a través de solicitudes de método OID de OID_NIC_SWITCH_ALLOCATE_VF.
Se pueden crear VPorts no predeterminados en el conmutador NIC a través de solicitudes de método OID de OID_NIC_SWITCH_CREATE_VPORT.

Para obtener más información sobre cómo controlar esta solicitud de OID, consulte Control de la solicitud de OID_NIC_SWITCH_CREATE_SWITCH.

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 método OID de OID_NIC_SWITCH_CREATE_SWITCH.

Código de estado	Descripción
NDIS_STATUS_SUCCESS	La solicitud de OID se completó correctamente.
NDIS_STATUS_NOT_SUPPORTED	El controlador de minipuerto PF no admite la interfaz SR-IOV o no está habilitado para usar la interfaz .
NDIS_STATUS_INVALID_PARAMETER	Uno o varios de los miembros de la estructura NDIS_NIC_SWITCH_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_PARAMETERS). El controlador de minipuerto PF debe establecer data . METHOD_INFORMATION. Miembro BytesNeeded 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.