structure NDIS_SRIOV_CAPABILITIES (ntddndis.h)

Article
08/07/2023

La structure NDIS_SRIOV_CAPABILITIES spécifie les fonctionnalités de virtualisation d’E/S racine unique (SR-IOV) de la carte réseau.

Syntaxe

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

Membres

Header

Type, révision et taille de la structure NDIS_SRIOV_CAPABILITIES . 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_CAPABILITIES , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_SRIOV_CAPABILITIES _REVISION_1

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

Définissez le membre Taille sur NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS

SriovCapabilities

Valeur ULONG qui contient un OR au niveau du bit des indicateurs suivants :

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Spécifie que la carte réseau prend en charge la fonctionnalité SR-IOV.

Note Cet indicateur doit uniquement être défini par le pilote miniport pour la fonction physique (PF) PCI Express (PCIe) de la carte réseau. Ce pilote 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.

NDIS_SRIOV_CAPS_PF_MINIPORT

Spécifie qu’il s’agit d’un pilote pf miniport.

NDIS_SRIOV_CAPS_VF_MINIPORT

Spécifie qu’il s’agit d’un pilote miniport de fonction virtuelle (VF) PCIe.

Remarques

Le pilote miniport utilise la structure NDIS_SRIOV_CAPABILITIES pour signaler ses fonctionnalités SR-IOV des manières suivantes :

Le pilote miniport appelle la fonction NdisMSetMiniportAttributes à partir de sa fonction MiniportInitializeEx et définit le paramètre MiniportAttributes sur un pointeur vers une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . Le pilote publie la prise en charge de SR-IOV en mettant en forme les membres HardwareSriovCapabilities et CurrentSriovCapabilities en tant que structures NDIS_SRIOV_CAPABILITIES .
Lorsque le pilote gère correctement une requête de requête OID de OID_SRIOV_HARDWARE_CAPABILITIES ou de OID_SRIOV_CURRENT_CAPABILITIES, il retourne une structure NDIS_SRIOV_CAPABILITIES .

NDIS transmet les fonctionnalités SR-IOV de la carte réseau aux pilotes qui se lient à la carte réseau de la manière suivante :

Lorsque NDIS appelle la fonction FilterAttach d’un pilote de filtre de sur-superposition, NDIS transmet les fonctionnalités SR-IOV de la carte réseau via le paramètre AttachParameters . Ce paramètre contient un pointeur vers une structure NDIS_FILTER_ATTACH_PARAMETERS . Le membre SriovCapabilities de cette structure contient un pointeur vers une structure NDIS_SRIOV_CAPABILITIES .
Lorsque NDIS appelle la fonction ProtocolBindAdapterEx d’un pilote de protocole overlying, NDIS transmet les fonctionnalités SR-IOV de la carte réseau via le paramètre BindParameters . Ce paramètre contient un pointeur vers une structure NDIS_FILTER_ATTACH_PARAMETERS . Le membre SriovCapabilities de cette structure contient un pointeur vers une structure NDIS_SRIOV_CAPABILITIES .