structure NDIS_SWITCH_PROPERTY_PARAMETERS (ntddndis.h)

Article
07/02/2025

La structure NDIS_SWITCH_PROPERTY_PARAMETERS spécifie les paramètres d’une propriété de stratégie d’un commutateur extensible Hyper-V.

Syntaxe

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PROPERTY_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_PARAMETERS, le membre révision de doit être défini sur la valeur suivante :

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

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

Définissez le membre taille sur NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_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 contenue dans la mémoire tampon de propriété.

PropertyId

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

Pour plus d’informations, consultez la section Remarques.

Remarque L’extension de commutateur extensible doit ignorer ce membre, sauf si le membre PropertyType est défini sur NdisSwitchPropertyTypeCustom.

PropertyVersion

Valeur NDIS_SWITCH_OBJECT_VERSION qui identifie la version de la propriété switch 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.

PropertyInstanceId

Valeur NDIS_SWITCH_OBJECT_INSTANCE_ID qui spécifie l’identificateur d’instance de la propriété de commutateur extensible.

PropertyBufferLength

Valeur ULONG qui spécifie la taille, en octets, de la mémoire tampon de propriété.

PropertyBufferOffset

Valeur ULONG qui spécifie le décalage, en octets, dans la mémoire tampon de propriété qui suit la structure NDIS_SWITCH_PROPERTY_PARAMETERS. Le décalage est mesuré du début de la structure NDIS_SWITCH_PROPERTY_PARAMETERS jusqu’au début de la mémoire tampon de propriété.

Remarques

La structure NDIS_SWITCH_PROPERTY_PARAMETERS est utilisée dans les requêtes de jeu d’OID suivantes :

La mémoire tampon de propriété contient une structure associée au membre PropertyType. La mémoire tampon de propriété suit la structure NDIS_SWITCH_PROPERTY_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.

Remarque à partir de Windows Server 2012, le membre PropertyType doit être défini sur NdisSwitchPropertyTypeCustom et la mémoire tampon de propriété doit contenir une structure NDIS_SWITCH_PROPERTY_CUSTOM.

Les extensions de commutateur extensible peuvent accéder à la mémoire tampon de propriété de commutateur extensible à l’intérieur d’une structure NDIS_SWITCH_PROPERTY_PARAMETERS à l’aide de la macro NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY.

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