structure NDIS_SWITCH_PROPERTY_CUSTOM (ntddndis.h)

Article
02/26/2024

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’éditeur de logiciels indépendants.

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’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_PROPERTY_CUSTOM , le membre Revision de Header doit avoir 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 un OR au niveau du bit d’indicateurs. 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, sur la mémoire tampon de propriété. Le décalage est mesuré 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 demandes 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 membre InformationBuffer 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 de 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 Stratégies de commutateur extensible Hyper-V.