structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS (ntddndis.h)

Article
02/07/2025

La structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS spécifie les paramètres d’une propriété de stratégie d’un port de commutateur extensible Hyper-V.

Syntaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_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_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Membres

Header

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

NDIS_SWITCH_PORT_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_PORT_PROPERTY_PARAMETERS_REVISION_1.

Flags

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

PortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible auquel la propriété est affectée.

PropertyType

Valeur d’énumération NDIS_SWITCH_PORT_PROPERTY_TYPE qui spécifie le type de propriété de port contenue dans la mémoire tampon de propriété.

PropertyId

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

Pour plus d’informations, consultez la section Remarques.

Remarque L’extension de commutateur extensible doit ignorer ce membre, sauf si le membre PropertyType est défini sur NdisSwitchPortPropertyTypeCustom.

PropertyVersion

Valeur NDIS_SWITCH_OBJECT_VERSION qui identifie la version de 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 l’accès par l’extension à partir du fichier MOF (Managed Object Format) qui a défini la propriété.

Remarque 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 identifie l’instance de la propriété pour le port 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, dans la mémoire tampon de propriété qui suit la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS. Le décalage est mesuré à partir du début de la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS jusqu’au début de la mémoire tampon de propriété.

Reserved

Réservé pour une utilisation ultérieure.

Remarques

La structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS est utilisée dans les requêtes 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_PORT_PROPERTY_PARAMETERS dans la mémoire tampon d’informations 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 d’informations.

L’extension de commutateur extensible doit suivre ces instructions lorsqu’elle traite une structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS :

Si le membre PropertyType a la valeur NdisSwitchPortPropertyTypeSecurity, la mémoire tampon de propriété est mise en forme en tant que structure NDIS_SWITCH_PORT_PROPERTY_SECURITY.
Si le membre PropertyType a la valeur NdisSwitchPortPropertyTypeVlan, la mémoire tampon de propriété est mise en forme sous forme de structure NDIS_SWITCH_PORT_PROPERTY_VLAN.
Si le membre PropertyType a la valeur NdisSwitchPortPropertyTypeProfile, la mémoire tampon de propriété est mise en forme sous forme de structure NDIS_SWITCH_PORT_PROPERTY_PROFILE.
Si le membre PropertyType est défini sur NdisSwitchPortPropertyTypeCustom, le PropertyId membre doit être défini sur la valeur GUID créée par le fournisseur de logiciels indépendant (ISV) pour la propriété de port personnalisée. La mémoire tampon de propriété est mise en forme sous la forme d’une structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM qui contient les paramètres de la propriété de port personnalisée telle que définie par l’éditeur de logiciels indépendants.

Les extensions de commutateur extensible peuvent accéder à la propriété de port personnalisée à l’intérieur d’une structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS à l’aide de la macro NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY.

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