structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Article
08/07/2023

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 en tant que 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’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS , le membre Revision de Header doit avoir 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 un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

PropertyType

Une 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 extensibles 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é.

Note Par 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, du 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.

Note 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 demandes 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 membre InformationBuffer 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 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 Stratégies de commutateur extensible Hyper-V.