structure NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Article
08/07/2023

La structure NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS spécifie les paramètres des informations de status personnalisées d’un port de commutateur extensible Hyper-V. Ces informations sont appelées informations sur les fonctionnalités status. Le format de ces informations est défini par l’éditeur de logiciels indépendant (ISV).

Les informations status sont spécifiées par le biais d’une structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM et sont retournées par le biais d’une requête de méthode OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY.

Syntaxe

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

Membres

Header

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

NDIS_SWITCH_PORT_FEATURE_STATUS_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_FEATURE_STATUS_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 spécifie l’identificateur numérique d’un port de commutateur extensible. Cette valeur identifie de manière unique le port sur le commutateur extensible pour lequel la fonctionnalité status informations doivent être retournées.

FeatureStatusType

Valeur d’énumération NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE qui spécifie le type des informations de status pour une propriété de profil de port de commutateur extensible personnalisée.

Note À compter de NDIS 6.30, ce membre doit être défini sur NdisSwitchPortPropertyTypeCustom.

FeatureStatusId

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

FeatureStatusVersion

Valeur NDIS_SWITCH_OBJECT_VERSION qui identifie la version de la propriété de profil 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.

FeatureStatusInstanceId

Valeur NDIS_SWITCH_OBJECT_INSTANCE_ID qui identifie le instance de la fonctionnalité status informations pour le port de commutateur extensible.

FeatureStatusBufferLength

Valeur ULONG qui spécifie la taille, en octets, de la fonctionnalité status mémoire tampon.

FeatureStatusBufferOffset

Valeur ULONG qui spécifie le décalage, en octets, de la fonctionnalité status mémoire tampon qui suit la structure NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS. La fonctionnalité status mémoire tampon contient une structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM.

Le décalage est mesuré du début de la structure NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS jusqu’au début de la structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

Reserved

Réservé pour un usage futur.

Remarques

La structure NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS est utilisée dans les requêtes de méthode OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY. Cette requête OID retourne les structures suivantes dans la mémoire tampon d’informations associée à la requête OID :

Structure NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS qui spécifie les paramètres d’une propriété personnalisée d’un port de commutateur extensible pour lequel status informations doivent être retournées. L’extension de commutateur remplit le membre FeatureStatusVersion de la structure pour refléter la version du status personnalisé retourné dans la mémoire tampon NDIS_SWITCH_FEATURE_STATUS_CUSTOM. Le commutateur Hyper-v Extensible remplit tous les autres membres lors de l’émission de l’OID de requête.
Structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM qui contient les informations de status pour la propriété de port de commutateur extensible. L’extension de commutateur remplit le membre FeatureStatusCustomBufferLength de la structure pour refléter la taille de la status personnalisée retournée. Le commutateur Hyper-v Extensible remplit tous les autres membres lors de l’émission de l’OID de requête.