estructura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

  • Artículo

La estructura de NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS especifica los parámetros de una operación de escritura en el bloque de configuración de la función virtual PCI Express (PCIe) de un adaptador de red (VF). Estos parámetros se usan para la comunicación backchannel entre el VF y los controladores de miniporte de la función física PCIe (PF).

Sintaxis

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El controlador debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1.

VFId

Valor NDIS_SRIOV_FUNCTION_ID que especifica el identificador único del VF en el adaptador de red.

Nota El VF con el valor de NDIS_SRIOV_FUNCTION_ID especificado debe tener recursos asignados previamente a través de una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_ALLOCATE_VF.
 

BlockId

Valor ULONG en el que se especifica el identificador del bloque de configuración de VF en el que se va a escribir. Este identificador es propietario del proveedor de hardware independiente (IHV) y solo lo usan los controladores de minipuerto para pf y VF en el adaptador de red.

Para obtener más información, vea la sección Comentarios.

Length

Valor ULONG que especifica la longitud, en unidades de bytes, de la operación de escritura.

BufferOffset

Valor ULONG que especifica el desplazamiento, en unidades de bytes, desde el principio de esta estructura hasta un búfer que contiene los datos que se van a escribir en el bloque de configuración de VF especificado.

Comentarios

La estructura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS se usa en una solicitud de conjunto de OID de OID_SRIOV_WRITE_VF_CONFIG_BLOCK.

Se usa un bloque de configuración VF para la comunicación backchannel entre los controladores del PCIe PF y un VF en un dispositivo que admite la interfaz SR-IOV. Los datos de un bloque de configuración de VF se pueden intercambiar entre los controladores siguientes:

  • Controlador de minipuerto de VF, que se ejecuta en el sistema operativo invitado. Este sistema operativo se ejecuta dentro de una partición secundaria de Hyper-V.
  • El controlador de miniporte PF, que se ejecuta en el sistema operativo de administración.

    Este sistema operativo se ejecuta dentro de la partición primaria de Hyper-V.

Nota El uso del bloque de configuración de VF y el formato de sus datos de configuración se definen mediante el proveedor de hardware independiente (IHV) del dispositivo. Los controladores de miniporte PF y VF usan los datos de configuración.
 
Para obtener más información sobre la comunicación backchannel dentro de la interfaz de virtualización de E/S raíz única (SR-IOV), consulte SR-IOV PF/VF Backchannel Communication.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite en NDIS 6.30 y versiones posteriores.
Encabezado ntddndis.h (include Ndis.h)

Consulte también

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK