struktur NDIS_SWITCH_PARAMETERS (ntddndis.h)

Artikel
02/29/2024

Struktur NDIS_SWITCH_PARAMETERS berisi data konfigurasi untuk sakelar Hyper-V yang dapat diperluas.

Sintaks

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Anggota

Header

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

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

NDIS_SWITCH_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1.

Flags

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

SwitchName

Nilai NDIS_SWITCH_NAME yang menentukan nama internal unik sakelar yang dapat diperluas.

Nama sakelar internal digunakan oleh aplikasi manajemen kebijakan berbasis WMI. Untuk informasi selengkapnya, lihat Mengelola Kebijakan Sakelar yang Dapat Diperluas Hyper-V.

SwitchFriendlyName

Nilai NDIS_SWITCH_FRIENDLYNAME yang menentukan deskripsi sakelar yang mudah digunakan.

NumSwitchPorts

Nilai UINT32 yang menentukan jumlah port yang dikonfigurasi pada sakelar yang dapat diperluas.

IsActive

BOOLEAN yang jika TRUE menunjukkan bahwa aktivasi sakelar yang dapat diperluas Hyper-V telah selesai dan aman untuk mengkueri konfigurasi switch lainnya seperti menghitung port, NIC, dan properti. Jika FALSE, ekstensi harus menunggu peristiwa NetEventSwitchActivate PNP dikeluarkan sebelum mengkueri konfigurasi switch.

Keterangan

Struktur NDIS_SWITCH_PARAMETERS digunakan dalam permintaan OID OID_SWITCH_PARAMETERS.

Struktur ini juga diteruskan dalam parameter vSwitch dari fungsi callout berikut untuk driver callout Windows Filtering Platform:

Catatan Jenis data NDIS_SWITCH_NAME dan NDIS_SWITCH_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.