struktur NDIS_SWITCH_PORT_PARAMETERS (ntddndis.h)

Artikel
02/26/2024

Struktur NDIS_SWITCH_PORT_PARAMETERS berisi data konfigurasi untuk port sakelar hyper-V yang dapat diperluas.

Sintaks

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

Anggota

Header

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

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

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1.

Flags

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

PortId

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

PortName

Nilai NDIS_SWITCH_PORT_NAME yang menentukan nama internal unik dari port sakelar yang dapat diperluas.

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

PortFriendlyName

Nilai NDIS_SWITCH_PORT_FRIENDLYNAME yang menentukan deskripsi port sakelar yang mudah diperluas.

PortType

Nilai NDIS_SWITCH_PORT_TYPE yang menentukan jenis port sakelar yang dapat diperluas.

IsValidationPort

Jika TRUE, menunjukkan port yang sementara dibuat untuk tujuan pengujian dan validasi sebelum koneksi adaptor jaringan VM dibuat. Untuk informasi selengkapnya tentang jenis port ini, lihat Port Validasi.

PortState

Nilai NDIS_SWITCH_PORT_STATE yang menentukan status port saat ini.

Keterangan

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_PORT_PARAMETERS untuk permintaan OID berikut:

Permintaan kueri OID dari OID_SWITCH_PORT_ARRAY mengembalikan struktur NDIS_SWITCH_PORT_ARRAY yang berisi array elemen. Setiap elemen diformat sebagai struktur NDIS_SWITCH_PORT_PARAMETERS .

Ekstensi sakelar yang dapat diperluas dapat mengakses buffer properti port di dalam struktur NDIS_SWITCH_PORT_PARAMETERS dengan menggunakan makro NDIS_SWITCH_PORT_AT_ARRAY_INDEX .

Catatan Jenis data NDIS_SWITCH_PORT_NAME dan NDIS_SWITCH_PORT_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.