structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Article
02/26/2024

La structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS spécifie un tableau de propriétés de stratégie pour un port de commutateur extensible Hyper-V. Chaque élément du tableau est mis en forme en tant que structure NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Syntaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Membres

Header

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

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

Définissez le membre Taille sur NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible pour lequel les propriétés sont énumérées.

PropertyType

Valeur d’énumération NDIS_SWITCH_PORT_PROPERTY_TYPE qui spécifie le type de propriété de port. Lorsqu’une demande de méthode OID de OID_SWITCH_PORT_PROPERTY_ENUM est émise, l’extension de commutateur extensible retourne les propriétés de port qui correspondent à ce type de propriété.

PropertyId

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

SerializationVersion

Valeur NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION qui identifie la version de format des données de propriété de port 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.

FirstPropertyOffset

Valeur USHORT qui spécifie le décalage, en octets, vers le premier élément NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO qui suit la structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . Le décalage est mesuré à partir du début de la structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS jusqu’au début du premier élément du tableau.

Note Si la valeur de NumProperties est zéro, ce membre est ignoré.

NumProperties

Valeur ULONG qui spécifie le nombre d’éléments NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO qui suivent la structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS .

Reserved

Réservé pour un usage futur.

Remarques

La structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS est utilisée dans les demandes de méthode OID de OID_SWITCH_PORT_PROPERTY_ENUM. Un tableau de structures NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO suit la structure NDIS_SWITCH_PORT_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 à la première structure NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO spécifiée par la structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS à l’aide de la macro NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO .

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