structure NDIS_SWITCH_PORT_PROPERTY_PROFILE (ntddndis.h)

Article
08/07/2023

La structure NDIS_SWITCH_PORT_PROPERTY_PROFILE spécifie une propriété de stratégie pour un port de commutateur extensible Hyper-V que l’extension de commutateur extensible enregistre dans son propre magasin de stratégies plutôt que dans le magasin de stratégies Hyper-V. Dans ce cas, les définitions de stratégie sont identifiées par des profils de propriétés dans le magasin de stratégies du pilote.

Syntaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

Membres

Header

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

Le membre Type de l’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_PORT_PROPERTY_PROFILE , le membre Revision de Header doit avoir la valeur suivante :

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1.

Flags

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

ProfileName

Valeur NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME qui spécifie le nom convivial de la propriété de profil.

ProfileId

Valeur GUID qui identifie de manière unique la propriété de profil.

VendorName

Valeur NDIS_VENDOR_NAME qui spécifie le nom convivial du fournisseur qui a défini le profil de port.

VendorId

Valeur GUID qui identifie le fournisseur qui a défini le profil de port.

ProfileData

NetCfgInstanceId

Valeur GUID qui spécifie la valeur de Registre NetCfgInstanceId de la connexion de carte réseau sous-jacente pour laquelle la propriété est appliquée.

La valeur NetCfgInstanceId est spécifiée pour la connexion de carte réseau via une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_CREATE.

PciLocation

Structure qui spécifie l’emplacement PCI de la carte réseau physique sous-jacente spécifiée par le membre NetCfgInstanceId .

Pour plus d'informations, consultez la section Notes.

PciLocation.PciSegmentNumber

Valeur qui spécifie le groupe de bus PCI sur lequel la carte réseau physique est attachée.

PciLocation.PciBusNumber

Valeur qui spécifie le numéro de bus PCI actuel sur lequel la carte réseau physique est attachée.

PciLocation.PciDeviceNumber

Valeur qui spécifie le numéro d’appareil de la carte réseau physique sur le bus PCI.

Note Le numéro d’appareil PCI est également appelé numéro d’emplacement PCI.

PciLocation.PciFunctionNumber

Valeur qui spécifie le numéro de fonction d’un appareil logique sur la carte réseau physique.

CdnLabelId

Valeur UINT32 qui spécifie un identificateur unique pour les données contenues dans le membre CdnLabel .

CdnLabel

Valeur NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL qui spécifie l’étiquette CDN PCI Express (PCIe) pour l’emplacement de la carte réseau physique. Une étiquette CDN fournit des emplacements d’appareil cohérents sur des emplacements matériels similaires.

Remarques

La structure NDIS_SWITCH_PORT_PROPERTY_PROFILE est utilisée par l’extension pour référencer une propriété de stratégie dans un magasin de stratégies privé au lieu du magasin de stratégies Hyper-V. Cela permet au fournisseur de logiciels indépendant (ISV) de remplir et de gérer ce magasin de stratégies privé par le biais de canaux et d’interfaces privés. Les fournisseurs peuvent distinguer leurs profils des autres fournisseurs à l’aide des champs VendorName et VendorId .

Note Les propriétés de stratégie de port spécifiées par une structure NDIS_SWITCH_PORT_PROPERTY_PROFILE sont transparentes pour l’interface de commutateur extensible.

La structure NDIS_SWITCH_PORT_PROPERTY_PROFILE est utilisée dans les demandes de jeu d’OID suivantes :

La structure NDIS_SWITCH_PORT_PROPERTY_PROFILE suit la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dans la mémoire tampon associée à ces demandes de jeu d’OID. Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon.

Note Les types de données NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME et NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL sont définis par la structure IF_COUNTED_STRING . Une chaîne définie par cette structure n’a pas besoin d’être terminée par null. Toutefois, la longueur de la chaîne doit être définie dans le membre Length de cette structure. Si la chaîne est terminée par null, le membre Length ne doit pas inclure le caractère null de fin.

Les membres PciLocation et CdnLabel ne sont pertinents que si le profil de propriété spécifie une stratégie pour une carte réseau physique sous-jacente attachée à la carte réseau externe du commutateur extensible. Par exemple, si la carte réseau externe est liée à une équipe de cartes de commutateur extensible, ces membres peuvent spécifier des stratégies pour une seule carte de cette équipe. Pour plus d’informations sur l’équipe de commutateur extensible, consultez Types de configurations de cartes réseau physiques.