NDIS_SWITCH_NIC_SAVE_STATE struttura (ntddndis.h)

Articolo
03/05/2024

La struttura NDIS_SWITCH_NIC_SAVE_STATE specifica le informazioni sullo stato di runtime per una porta estendibile Hyper-V. L'estensione del commutatore estendibile usa questa struttura per salvare o ripristinare le informazioni sulla porta di runtime.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_NIC_SAVE_STATE . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il membro Type di Intestazione deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SWITCH_NIC_SAVE_STATE , è necessario impostare il membro Revisionedell'intestazione sul valore seguente:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

PortId

Valore NDIS_SWITCH_PORT_ID contenente l'identificatore univoco della porta del commutatore estendibile.

NicIndex

Valore NDIS_SWITCH_NIC_INDEX contenente l'indice di interfaccia di rete per la scheda di rete. Questo valore sarà sempre 0. Per altre informazioni, vedere Valori di indice della scheda di rete.

ExtensionId

Valore GUID che identifica l'estensione del commutatore estendibile.

ExtensionFriendlyName

Valore NDIS_SWITCH_EXTENSION_FRIENDLYNAME che specifica la descrizione descrittiva dell'estensione del commutatore estendibile.

FeatureClassId

Valore GUID contenente l'identificatore della classe di funzionalità correlata ai dati salvati. Un identificatore della classe di funzionalità viene definito dall'estensione per identificare in modo univoco i componenti dei relativi dati di runtime.

Nota Questo membro è facoltativo. L'estensione dell'opzione estendibile deve impostare questo membro su 0 se i dati salvati non hanno una classe di funzionalità.

SaveDataSize

Valore USHORT che specifica le dimensioni, in byte, dei dati contenuti nel membro SaveData .

Nota Questo valore deve essere minore o uguale a NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE.

SaveDataOffset

Valore USHORT che contiene l'offset dall'inizio della struttura alle informazioni sullo stato di runtime salvate o ripristinate.

SaveDataSizeOverflow

Commenti

La struttura NDIS_SWITCH_NIC_SAVE_STATE viene usata nelle richieste OID seguenti:

Nota Il tipo di dati NDIS_SWITCH_EXTENSION_FRIENDLYNAME è definito dalla struttura IF_COUNTED_STRING . Una stringa definita da questa struttura non deve essere terminata con null. Tuttavia, la lunghezza della stringa deve essere impostata nel membro Length di questa struttura. Se la stringa è terminata con valore Null, il membro Length non deve includere il carattere Null terminante.

Per altre informazioni su come salvare o ripristinare le informazioni sulla porta di runtime, vedere Gestione dell'opzione estendibile Hyper-V Run-Time Dati.