OID_NIC_SWITCH_PARAMETERS

Artículo
03/13/2025

Un controlador demasiado excesivo emite una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_PARAMETERS para obtener los parámetros de configuración actuales de un conmutador NIC especificado en un adaptador de red. NDIS controla estas solicitudes de método OID para el controlador de miniport.

Los controladores excesivos emiten una solicitud de conjunto de OID de OID_NIC_SWITCH_PARAMETERS para establecer los parámetros de configuración de un conmutador NIC especificado en un adaptador de red. Estas solicitudes de conjunto de OID se emiten al controlador de minipuerto de la función física (PF) del adaptador de red PCI Express (PCIe). Estas solicitudes de conjunto de OID son necesarias 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 una estructura NDIS_NIC_SWITCH_PARAMETERS.

El controlador sobrepuesto especifica el modificador NIC para el método OID o establecer la solicitud estableciendo el SwitchId miembro de la estructura de NDIS_NIC_SWITCH_PARAMETERS en el identificador del conmutador. El controlador que sobrepone obtiene el identificador del modificador a través de una de las siguientes maneras:

A partir de una solicitud de método OID anterior de OID_NIC_SWITCH_ENUM_SWITCHES.
Desde el miembro NicSwitchArray de la estructura NDIS_BIND_PARAMETERS. NDIS pasa un puntero a esta estructura en el parámetro BindParameters de la función ProtocolBindAdapterEx.
Desde el miembro NicSwitchArray de la estructura NDIS_FILTER_ATTACH_PARAMETERS. NDIS pasa un puntero a esta estructura en el parámetro AttachParameters del parámetro FilterAttach.

Nota a partir de Windows Server 2012, Windows solo admite el conmutador NIC predeterminado en el adaptador de red. El miembro SwitchId de la estructura de NDIS_NIC_SWITCH_PARAMETERS debe establecerse en NDIS_DEFAULT_SWITCH_ID.

Observaciones

El controlador excesivo emite OID_NIC_SWITCH_PARAMETERS solicitudes de la siguiente manera:

El controlador sobrecalado emite una solicitud de método OID de OID_NIC_SWITCH_PARAMETERS para obtener los parámetros actuales de un conmutador de NIC especificado. Para obtener más información, consulte Consulta de los parámetros de un conmutador NIC.

Nota NDIS controla las solicitudes de método OID de OID_NIC_SWITCH_PARAMETERS para el controlador de miniport PF.
El controlador sobrecalado emite una solicitud de conjunto de OID de OID_NIC_SWITCH_PARAMETERS para cambiar los parámetros actuales de un conmutador de NIC especificado. Para obtener más información, vea Establecer los parámetros de un conmutador NIC.

Nota El controlador de miniport pf controla las solicitudes de conjunto de OID de OID_NIC_SWITCH_PARAMETERS.

Códigos de estado de retorno

NDIS o el controlador de miniport pf devuelven los siguientes códigos de estado para las solicitudes OID establecidas o de método de OID_NIC_SWITCH_PARAMETERS.

Código de estado	Descripción
NDIS_STATUS_SUCCESS	La solicitud se completó correctamente. El informationBuffer de apunta a una estructura de NDIS_NIC_SWITCH_CAPABILITIES.
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_PARAMETERS tienen valores no válidos.
NDIS_STATUS_INVALID_LENGTH	El búfer de información era demasiado corto. NDIS o el controlador de miniporte PF establece el DATA. METHOD_INFORMATION. BytesNeeded miembro (para solicitudes de método OID) o DATA. SET_INFORMATION. BytesNeeded miembro (para solicitudes de conjunto de OID) en la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_REINIT_REQUIRED	El controlador de miniporte PF requiere una reinicialización del adaptador de red para aplicar los cambios en el conmutador NIC.
NDIS_STATUS_FAILURE	Error en la solicitud por otros motivos.