NDIS_SWITCH_NIC_SAVE_STATE structure (ntddndis.h)

Article
02/29/2024

La structure NDIS_SWITCH_NIC_SAVE_STATE spécifie les informations d’état d’exécution pour 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’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_NIC_SAVE_STATE , le membre Revision de Header doit avoir 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 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.

NicIndex

Valeur NDIS_SWITCH_NIC_INDEX qui contient l’index de carte réseau pour la carte réseau. Cette valeur sera toujours égale à 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é 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.

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

Note 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 en cours d’enregistrement ou de restauration.

SaveDataSizeOverflow

Remarques

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

Note 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 se termine par un caractère 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 du commutateur extensible Hyper-V Run-Time Data.