NDIS_SWITCH_PORT_PROPERTY_PARAMETERS structure (ntddndis.h)

Article
08/07/2023

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’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 Header 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 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 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 Notes.

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

PropertyInstanceId

Valeur NDIS_SWITCH_OBJECT_INSTANCE_ID qui identifie le 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, sur la mémoire tampon de propriétés 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 un usage futur.

Remarques

La structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS est utilisée dans les demandes 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és suit la structure NDIS_SWITCH_PORT_PROPERTY_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.

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

Si le membre PropertyType est défini sur 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 est défini sur NdisSwitchPortPropertyTypeVlan, la mémoire tampon de propriété est mise en forme en tant que structure NDIS_SWITCH_PORT_PROPERTY_VLAN .
Si le membre PropertyType est défini sur NdisSwitchPortPropertyTypeProfile, la mémoire tampon de propriété est mise en forme en tant que structure NDIS_SWITCH_PORT_PROPERTY_PROFILE .
Si le membre PropertyType est défini sur NdisSwitchPortPropertyTypeCustom, le membre PropertyId doit être défini sur la valeur GUID que le fournisseur de logiciels indépendant (ISV) a créée pour la propriété de port personnalisée. La mémoire tampon de propriétés est mise en forme en tant que 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épendant.

Les extensions de commutateur extensible peuvent accéder à la propriété de port personnalisé à 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 Stratégies de commutateur extensible Hyper-V.