NDIS_SWITCH_PROPERTY_PARAMETERS structure (ntddndis.h)

Article
03/01/2024

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’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_PROPERTY_PARAMETERS , le membre Revision de Header doit avoir 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 un OR au niveau du bit d’indicateurs. 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 Notes.

Note 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é 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 y accéder par l’extension à partir du fichier MOF (Managed Object Format) qui a défini la propriété.

Note 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 de 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, sur la mémoire tampon de propriétés 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 demandes 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 membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon d’informations.

Note À compter 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 Stratégies de commutateur extensible Hyper-V.