structure NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

Article
08/07/2023

La structure NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS spécifie les paramètres d’une opération de lecture sur le bloc de configuration de la fonction virtuelle (VF) PCI Express (PCIe) d’une carte réseau. Ces paramètres sont utilisés pour la communication backchannel entre les pilotes miniport d’une VF et la fonction physique PCIe (PF).

Syntaxe

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;

Membres

Header

Type, révision et taille de la structure NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Size sur NDIS_SIZEOF_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1.

VFId

Valeur NDIS_SRIOV_FUNCTION_ID qui spécifie l’identificateur unique de la VF sur la carte réseau.

Note La VF avec la valeur NDIS_SRIOV_FUNCTION_ID spécifiée doit avoir des ressources qui ont été précédemment allouées via une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

BlockId

Valeur ULONG qui spécifie l’identificateur du bloc de configuration VF à lire. Cet identificateur est propriétaire du fournisseur de matériel indépendant (IHV) et est utilisé uniquement par les pilotes miniport pour le PF et la VF sur la carte réseau.

Pour plus d'informations, consultez la section Notes.

Length

Valeur ULONG qui spécifie la longueur, en unités d’octets, de l’opération de lecture.

BufferOffset

Valeur ULONG qui spécifie le décalage, en unités d’octets, entre le début de cette structure et une mémoire tampon qui contient les données lues à partir du bloc de configuration VF spécifié.

Remarques

La structure NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS est utilisée dans les demandes de méthode OID de OID_SRIOV_READ_VF_CONFIG_BLOCK.

Un bloc de configuration VF est utilisé pour la communication backchannel entre les pilotes du PF PCIe et une VF sur un appareil qui prend en charge l’interface SR-IOV. Les données d’un bloc de configuration VF peuvent être échangées entre les pilotes suivants :

Pilote miniport VF, qui s’exécute dans le système d’exploitation invité. Ce système d’exploitation s’exécute dans une partition enfant Hyper-V.
Pilote pf miniport, qui s’exécute dans le système d’exploitation de gestion.
Ce système d’exploitation s’exécute dans la partition parente Hyper-V.

Note L’utilisation du bloc de configuration VF et le format de ses données de configuration sont définis par le fournisseur de matériel indépendant (IHV) de l’appareil. Les données de configuration sont utilisées uniquement par les pilotes PF et VF miniport.

Pour plus d’informations sur la communication backchannel au sein de l’interface de virtualisation d’E/S racine unique (SR-IOV), consultez Communication backchannel SR-IOV PF/VF.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.30 et versions ultérieures.
En-tête	ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK

Partager via