structure NDIS_SWITCH_PROPERTY_CUSTOM (ntddndis.h)

Article
02/07/2025

La structure NDIS_SWITCH_PROPERTY_CUSTOM spécifie une propriété de profil personnalisé pour le commutateur extensible Hyper-V.

Les éditeurs de logiciels indépendants définissent le format des propriétés personnalisées. Le format de la propriété personnalisée est propriétaire de l’ISV.

Syntaxe

typedef struct _NDIS_SWITCH_PROPERTY_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              PropertyBufferLength;
  ULONG              PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_CUSTOM, *PNDIS_SWITCH_PROPERTY_CUSTOM;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PROPERTY_CUSTOM. 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_CUSTOM, le membre Révision de l'd’en-tête doit être défini sur la valeur suivante :

NDIS_SWITCH_PROPERTY_CUSTOM_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_CUSTOM_REVISION_1.

Flags

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

PropertyBufferLength

Valeur ULONG qui spécifie la taille, en octets, de la mémoire tampon qui contient la propriété de commutateur extensible personnalisée.

PropertyBufferOffset

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

Remarques

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

La structure NDIS_SWITCH_PROPERTY_CUSTOM suit la structure NDIS_SWITCH_PROPERTY_PARAMETERS dans la mémoire tampon 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.

Les extensions de commutateur extensible peuvent accéder à la mémoire tampon de propriété de commutateur extensible personnalisée spécifiée par une structure NDIS_SWITCH_PROPERTY_CUSTOM à l’aide de la macro NDIS_SWITCH_PROPERTY_CUSTOM_GET_BUFFER.

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