structure NDIS_SWITCH_FEATURE_STATUS_PARAMETERS (ntddndis.h)

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

Les informations d’état sont spécifiées par le biais d’une structure NDIS_SWITCH_FEATURE_STATUS_CUSTOM qui est retournée par le biais d’une requête de méthode OID (Object Identifier) de OID_SWITCH_FEATURE_STATUS_QUERY.

Syntaxe

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

Membres

Header

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

Valeur ULONG qui contient un or au niveau du bit des indicateurs. Ce membre est réservé à NDIS.

FeatureStatusType

Valeur d’énumération NDIS_SWITCH_FEATURE_STATUS_TYPE qui spécifie le type des informations d’état des fonctionnalités pour le commutateur extensible.

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

FeatureStatusId

Valeur GUID qui identifie les informations d’état des fonctionnalités pour le commutateur extensible.

Cette valeur est définie dans la définition de classe MOF (Managed Object Format) pour les informations d’état des fonctionnalités. Pour plus d’informations, consultez Définition et inscription de propriétés switch personnalisées.

FeatureStatusInstanceId

Valeur NDIS_SWITCH_OBJECT_INSTANCE_ID qui identifie l’instance des informations d’état des fonctionnalités pour le commutateur extensible.

FeatureStatusVersion

Valeur NDIS_SWITCH_OBJECT_VERSION qui identifie la version des informations d’état des fonctionnalités pour le commutateur extensible. Cette valeur est définie dans la définition de classe MOF pour les informations d’état des fonctionnalités.

SerializationVersion

Valeur NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION qui identifie la version de format des informations d’état sérialisées pour les informations d’état de la fonctionnalité. Ces données sont sérialisées pour l’accès par l’extension à partir du fichier MOF 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.
 

FeatureStatusBufferOffset

Valeur ULONG qui spécifie le décalage, en octets, vers la mémoire tampon d’état des fonctionnalités qui suit la structure NDIS_SWITCH_FEATURE_STATUS_PARAMETERS . La mémoire tampon d’état contient une structure NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

Le décalage est mesuré à partir du début de la structure NDIS_SWITCH_FEATURE_STATUS_PARAMETERS jusqu’au début de la structure NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

FeatureStatusBufferLength

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

Remarques

La structure NDIS_SWITCH_FEATURE_STATUS_PARAMETERS est utilisée dans les requêtes de méthode OID de OID_SWITCH_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_FEATURE_STATUS_PARAMETERS qui spécifie les paramètres d’état pour les informations d’état des fonctionnalités du commutateur extensible. L’extension de commutateur remplit le membre FeatureStatusVersion de la structure pour refléter la version de l’état personnalisé retournée dans la mémoire tampon NDIS_SWITCH_FEATURE_STATUS_CUSTOM. Le commutateur Extensible Hyper-v remplit tous les autres membres lors de l’émission de l’OID de requête.
  • Structure NDIS_SWITCH_FEATURE_STATUS_CUSTOM qui contient les informations d’état des fonctionnalités pour le commutateur extensible. L’extension de commutateur remplit le membre FeatureStatusCustomBufferLength de la structure pour refléter la taille de l’état personnalisé retourné. Le commutateur Extensible Hyper-v remplit tous les autres membres lors de l’émission de l’OID de requête.

Configuration requise

   
Client minimal pris en charge Pris en charge dans NDIS 6.30 et versions ultérieures.
En-tête ntddndis.h (include Ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY