structure NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

  • Article

La structure NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS spécifie les paramètres d’une opération d’écriture 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 la VF et les pilotes miniports PF (PCIe Physical Function).

Syntaxe

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;

Membres

Header

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

Le pilote 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_WRITE_VF_CONFIG_BLOCK_PARAMETERS , le pilote doit définir le membre Révisiond’En-tête sur la valeur suivante :

NDIS_SRIOV_WRITE_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_WRITE_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 de 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 d’identificateur d’objet (OID) de OID_NIC_SWITCH_ALLOCATE_VF.
 

BlockId

Valeur ULONG qui spécifie l’identificateur du bloc de configuration VF dans lequel écrire. 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 d’écriture.

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 à écrire dans le bloc de configuration VF spécifié.

Remarques

La structure NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS est utilisée dans une demande de jeu OID de OID_SRIOV_WRITE_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_WRITE_VF_CONFIG_BLOCK