structure NDIS_SWITCH_NIC_SAVE_STATE (ntddndis.h)

Article
02/07/2025

La structure NDIS_SWITCH_NIC_SAVE_STATE spécifie les informations d’état d’exécution d’un port de commutateur extensible Hyper-V. L’extension de commutateur extensible utilise cette structure pour enregistrer ou restaurer les informations de port d’exécution.

Syntaxe

typedef struct _NDIS_SWITCH_NIC_SAVE_STATE {
  NDIS_OBJECT_HEADER                 Header;
  ULONG                              Flags;
  NDIS_SWITCH_PORT_ID                PortId;
  NDIS_SWITCH_NIC_INDEX              NicIndex;
  GUID                               ExtensionId;
  NDIS_SWITCH_EXTENSION_FRIENDLYNAME ExtensionFriendlyName;
  GUID                               FeatureClassId;
  USHORT                             SaveDataSize;
  USHORT                             SaveDataOffset;
  ULONG                              SaveDataSizeOverflow;
} NDIS_SWITCH_NIC_SAVE_STATE, *PNDIS_SWITCH_NIC_SAVE_STATE;

Membres

Header

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

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

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

Définissez le membre taille sur NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_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.

NicIndex

Valeur NDIS_SWITCH_NIC_INDEX qui contient l’index de carte réseau pour la carte réseau. Cette valeur sera toujours 0. Pour plus d’informations, consultez valeurs d’index de carte réseau.

ExtensionId

Valeur GUID qui identifie l’extension de commutateur extensible.

ExtensionFriendlyName

Valeur NDIS_SWITCH_EXTENSION_FRIENDLYNAME qui spécifie la description conviviale de l’extension de commutateur extensible.

FeatureClassId

Valeur GUID qui contient l’identificateur de la classe de fonctionnalités liée aux données enregistrées. Un identificateur de classe de fonctionnalité est défini par l’extension pour identifier de manière unique les composants de ses données d’exécution.

Remarque Ce membre est facultatif. L’extension de commutateur extensible doit définir ce membre sur 0 si les données enregistrées n’ont aucune classe de fonctionnalité.

SaveDataSize

Valeur USHORT qui a spécifié la taille, en octets, des données contenues dans le membre SaveData.

Remarque Cette valeur doit être inférieure ou égale à NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE.

SaveDataOffset

Valeur USHORT qui contient le décalage entre le début de la structure et les informations d’état d’exécution enregistrées ou restaurées.

SaveDataSizeOverflow

Remarques

La structure NDIS_SWITCH_NIC_SAVE_STATE est utilisée dans les requêtes OID suivantes :

Remarque Le type de données NDIS_SWITCH_EXTENSION_FRIENDLYNAME est défini par la structure IF_COUNTED_STRING. Une chaîne définie par cette structure n’a pas besoin d’être terminée par null. Toutefois, la longueur de la chaîne doit être définie dans le membre Length de cette structure. Si la chaîne est terminée par null, le membre Length ne doit pas inclure le caractère Null de fin.

Pour plus d’informations sur l’enregistrement ou la restauration des informations de port d’exécution, consultez Gestion des Hyper-V commutateur extensible Run-Time données.