structure NDIS_SWITCH_PROPERTY_ENUM_INFO (ntddndis.h)

Article
08/07/2023

La structure NDIS_SWITCH_PROPERTY_ENUM_INFO spécifie des informations sur une propriété de profil pour le commutateur extensible Hyper-V.

Syntaxe

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PROPERTY_ENUM_INFO . 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_INFO , le membre Revision de Header doit avoir la valeur suivante :

NDIS_SWITCH_PROPERTY_ENUM_INFO_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.

PropertyInstanceId

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

PropertyVersion

Valeur NDIS_SWITCH_OBJECT_VERSION qui identifie la version de la propriété pour le port de commutateur extensible.

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

Note Cette valeur doit être inférieure ou égale à la valeur du membre QwordAlignedPropertyBufferLength .

PropertyBufferOffset

Valeur ULONG qui spécifie le décalage, en octets, sur la mémoire tampon de propriété qui suit la structure NDIS_SWITCH_PROPERTY_ENUM_INFO . 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_ENUM_INFO est utilisée dans les demandes de jeu 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 à l’élément NDIS_SWITCH_PROPERTY_ENUM_INFO suivant une structure de NDIS_SWITCH_PROPERTY_ENUM_INFO dans le tableau à l’aide de la macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT .

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

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