structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Article
02/07/2025

La structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS spécifie un tableau de propriétés de profil pour le commutateur extensible Hyper-V. Chaque élément du tableau est mis en forme sous forme de structure NDIS_SWITCH_PROPERTY_ENUM_INFO.

Syntaxe

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

Membres

Header

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

Le membre type de l'd’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, le membre Révision de de révision doit être défini sur la valeur suivante :

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyType

Valeur d’énumération NDIS_SWITCH_PROPERTY_TYPE qui spécifie le type de propriété de commutateur extensible. Lorsqu’une demande de méthode OID de OID_SWITCH_PROPERTY_ENUM est émise, l’extension de commutateur extensible retourne des propriétés de commutateur extensible qui correspondent à ce type de propriété.

PropertyId

Valeur GUID qui identifie la propriété de commutateur extensible.

SerializationVersion

Valeur NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION qui identifie la version de format des données de propriété de commutateur extensible sérialisées. Ces données sont sérialisées pour l’accès par l’extension à partir du fichier MOF (Managed Object Format) qui a défini la propriété.

Remarque pour Windows Server 2012, le membre SerializationVersion doit être défini sur NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FirstPropertyOffset

Valeur USHORT qui spécifie le décalage, en octets, au premier élément NDIS_SWITCH_PROPERTY_ENUM_INFO qui suit la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS. Le décalage est mesuré du début de la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS jusqu’au début du premier élément du tableau.

Remarque Si la valeur de NumProperties est égale à zéro, ce membre est ignoré.

NumProperties

Valeur ULONG qui spécifie le nombre d’éléments NDIS_SWITCH_PROPERTY_ENUM_INFO qui suivent la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS.

Remarques

La structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS est utilisée dans les requêtes de méthode OID de OID_SWITCH_PROPERTY_ENUM. Un tableau de structures NDIS_SWITCH_PROPERTY_ENUM_INFO suit la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS dans la mémoire tampon d’informations associée à ces demandes de jeu d’OID. Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon d’informations.

Les extensions de commutateur extensible peuvent accéder à la première structure de NDIS_SWITCH_PROPERTY_ENUM_INFO spécifiée par la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS à l’aide de la macro NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO.

Pour plus d’informations sur les stratégies de commutateur extensible, consultez Hyper-V stratégies de commutateur extensible.