struktur NDIS_SWITCH_NIC_SAVE_STATE (ntddndis.h)

Artikel
02/26/2024

Struktur NDIS_SWITCH_NIC_SAVE_STATE menentukan informasi status run-time untuk port sakelar yang dapat diperluas Hyper-V. Ekstensi sakelar yang dapat diperluas menggunakan struktur ini untuk menyimpan atau memulihkan informasi port run-time.

Sintaks

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;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SWITCH_NIC_SAVE_STATE . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Anggota JenisHeader harus diatur ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SWITCH_NIC_SAVE_STATE , anggota RevisiHeader harus diatur ke nilai berikut:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera. Anggota ini dicadangkan untuk NDIS.

PortId

Nilai NDIS_SWITCH_PORT_ID yang berisi pengidentifikasi unik dari port sakelar yang dapat diperluas.

NicIndex

Nilai NDIS_SWITCH_NIC_INDEX yang berisi Indeks Nic untuk adaptor jaringan. Nilai ini akan selalu 0. Untuk informasi selengkapnya, lihat Nilai Indeks Adapter Jaringan.

ExtensionId

Nilai GUID yang mengidentifikasi ekstensi sakelar yang dapat diperluas.

ExtensionFriendlyName

Nilai NDIS_SWITCH_EXTENSION_FRIENDLYNAME yang menentukan deskripsi ekstensi sakelar yang dapat diperluas.

FeatureClassId

Nilai GUID yang berisi pengidentifikasi kelas fitur yang terkait dengan data yang disimpan. Pengidentifikasi kelas fitur didefinisikan oleh ekstensi untuk mengidentifikasi komponen data run-time secara unik.

Catatan Anggota ini bersifat opsional. Ekstensi sakelar yang dapat diperluas harus mengatur anggota ini ke 0 jika data yang disimpan tidak memiliki kelas fitur.

SaveDataSize

Nilai USHORT yang menentukan ukuran, dalam byte, dari data yang terkandung dalam anggota SaveData .

Catatan Nilai ini harus kurang dari atau sama dengan NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE.

SaveDataOffset

Nilai USHORT yang berisi offset dari awal struktur hingga informasi status run-time yang disimpan atau dipulihkan.

SaveDataSizeOverflow

Keterangan

Struktur NDIS_SWITCH_NIC_SAVE_STATE digunakan dalam permintaan OID berikut:

Catatan Jenis data NDIS_SWITCH_EXTENSION_FRIENDLYNAME ditentukan oleh struktur IF_COUNTED_STRING . String yang ditentukan oleh struktur ini tidak harus dihentikan null. Namun, panjang string harus diatur dalam anggota Panjang struktur ini. Jika string dihentikan null, anggota Panjang tidak boleh menyertakan karakter null yang mengakhiri.

Untuk informasi selengkapnya tentang cara menyimpan atau memulihkan informasi port run-time, lihat Mengelola Hyper-V Extensible Switch Run-Time Data.