OID_NIC_SWITCH_VF_PARAMETERS

Una aplicación en modo de usuario o controlador excesiva emite una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_VF_PARAMETERS para obtener los parámetros de configuración actuales de una función virtual PCI Express (PCIe) (VF) en un adaptador de red. Solo se pueden consultar las máquinas virtuales que tienen recursos asignados a través de una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF a través de una solicitud de método OID de OID_NIC_SWITCH_VF_PARAMETERS.

NDIS controla la solicitud del método OID de OID_NIC_SWITCH_VF_PARAMETERS para controladores de miniport.

Cuando se realiza la solicitud del método OID, el informationBuffer miembro de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_NIC_SWITCH_VF_PARAMETERS.

Observaciones

La aplicación de modo de usuario o controlador sobrepuesto especifica el VF que se va a consultar estableciendo el VFId miembro de la estructura de NDIS_NIC_SWITCH_VF_PARAMETERS en el identificador del VF. El controlador o la aplicación excesivamente se obtiene el identificador de VF a través de una de las siguientes maneras:

• Al emitir una solicitud de método OID de OID_NIC_SWITCH_ENUM_VFS.

  Si esta solicitud de OID se completa correctamente, la aplicación de controlador o modo de usuario excesiva recibe una lista de todas las máquinas virtuales asignadas en el adaptador de red. Cada elemento de la lista es una estructura NDIS_NIC_SWITCH_VF_INFO, con el identificador VF especificado por el miembro VFId.

• Mediante la emisión de una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

  Si esta solicitud de OID se completa correctamente, el controlador de sobresuso recibe el identificador de la VF recién creada en el VFId miembro de la estructura de NDIS_NIC_SWITCH_VF_PARAMETERS devuelta.

  Nota Solo los controladores de exceso pueden obtener el identificador VF de esta manera.

Después de una devolución correcta de la solicitud del método OID, el miembro InformationBu ffer de la estructura de NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_NIC_SWITCH_VF_PARAMETERS. Esta estructura contiene los parámetros de configuración del VF especificado.

Códigos de estado de retorno

NDIS controla la solicitud de método OID de OID_NIC_SWITCH_VF_PARAMETERS para controladores de miniport y devuelve el siguiente código de estado para las solicitudes de método OID de OID_NIC_SWITCH_VF_PARAMETERS.

Requisitos

Consulte también

NDIS_NIC_SWITCH_VF_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_ENUM_VFS

NDIS_NIC_SWITCH_VF_INFO