estructura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

  • Artículo

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

Sintaxis

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

Miembros

Header

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

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

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_SRIOV_READ_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 OID de OID_NIC_SWITCH_ALLOCATE_VF.
 

BlockId

Valor ULONG que especifica el identificador del bloque de configuración de VF que se va a leer. Este identificador es propietario del proveedor de hardware independiente (IHV) y solo lo usan los controladores de miniport 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 lectura.

BufferOffset

Valor de 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 leen desde el bloque de configuración de VF especificado.

Comentarios

La estructura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS se usa en las solicitudes de método OID de OID_SRIOV_READ_VF_CONFIG_BLOCK.

Un bloque de configuración de VF se usa 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 siguientes controladores:

  • Controlador de minipuerto VF, que se ejecuta en el sistema operativo invitado. Este sistema operativo se ejecuta dentro de una partición secundaria de Hyper-V.
  • Controlador de minipuerto 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 datos de configuración solo los usan los controladores de miniporte PF y VF.
 
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 Compatible con NDIS 6.30 y versiones posteriores.
Encabezado ntddndis.h (include Ndis.h)

Consulte también

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK