struktur NDIS_SWITCH_NIC_ARRAY (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_NIC_ARRAY menentukan array parameter konfigurasi adaptor jaringan. Setiap elemen dalam array menentukan parameter untuk adaptor jaringan yang terhubung ke port pada sakelar yang dapat diperluas Hyper-V. Setiap elemen diformat sebagai struktur NDIS_SWITCH_NIC_PARAMETERS .

Sintaks

typedef struct _NDIS_SWITCH_NIC_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_NIC_ARRAY, *PNDIS_SWITCH_NIC_ARRAY;

Anggota

Header

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

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

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

Flags

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

FirstElementOffset

Nilai USHORT yang menentukan offset, dalam byte, ke elemen pertama dalam array elemen yang mengikuti struktur ini. Offset diukur dari awal struktur NDIS_SWITCH_NIC_ARRAY hingga awal elemen pertama. Setiap elemen dalam array adalah struktur NDIS_SWITCH_NIC_PARAMETERS .

Catatan Jika NumElements diatur ke nol, anggota ini diabaikan.

NumElements

Nilai ULONG yang menentukan jumlah elemen NDIS_SWITCH_NIC_PARAMETERS yang mengikuti struktur NDIS_SWITCH_NIC_ARRAY .

ElementSize

Nilai ULONG yang menentukan ukuran, dalam byte, dari elemen NDIS_SWITCH_NIC_PARAMETERS yang mengikuti struktur NDIS_SWITCH_NIC_ARRAY .

Keterangan

Struktur NDIS_SWITCH_NIC_ARRAY dikembalikan dalam permintaan kueri OID OID_SWITCH_NIC_ARRAY. Array struktur NDIS_SWITCH_NIC_PARAMETERS mengikuti struktur NDIS_SWITCH_NIC_ARRAY dalam buffer informasi yang terkait dengan permintaan kueri OID. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer informasi ini.

Ekstensi sakelar yang dapat diperluas dapat mengakses struktur NDIS_SWITCH_NIC_PARAMETERS individual di dalam struktur NDIS_SWITCH_NIC_ARRAY dengan menggunakan makro NDIS_SWITCH_NIC_AT_ARRAY_INDEX .