structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM (ntddndis.h)

Article
02/07/2025

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

Syntaxe

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusBufferLength;
  ULONG              FeatureStatusBufferOffset;
} NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM;

Membres

Header

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

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1

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

Définissez le membre Size sur NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1.

Flags

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

FeatureStatusBufferLength

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

FeatureStatusBufferOffset

Valeur ULONG qui spécifie le décalage, en octets, vers la mémoire tampon d’état de la fonctionnalité qui suit la structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM. Le décalage est mesuré du début de la structure NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM jusqu’au début de la mémoire tampon d’état de la fonctionnalité.

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 des informations d’état des fonctionnalités à retourner pour un port de commutateur extensible. L’extension de commutateur remplit le membre FeatureStatusVersion de la structure pour refléter la version de l’état personnalisé retourné 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_PORT_FEATURE_STATUS_CUSTOM qui contient les données d’état des fonctionnalités pour le port de commutateur extensible spécifié. L’extension de commutateur remplit la FeatureStatusCustomBufferLength membre 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.

Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon d’informations.