struktur NDIS_NIC_SWITCH_INFO_ARRAY (ntddndis.h)

Artikel
09/24/2022
2 menit untuk membaca

Struktur NDIS_NIC_SWITCH_INFO_ARRAY menentukan array. Setiap elemen dalam array menentukan atribut sakelar adaptor jaringan yang telah dibuat pada adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

Anggota

Header

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

NDIS mengatur jenis anggotaHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_NIC_SWITCH_INFO_ARRAY , NDIS mengatur anggota RevisiHeader ke nilai berikut:

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Versi asli untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1.

FirstElementOffset

Nilai ULONG yang menentukan offset, dalam byte, ke elemen pertama dalam array elemen yang mengikuti struktur ini. Offset diukur dari awal struktur NDIS_NIC_SWITCH_INFO_ARRAY hingga awal elemen pertama. Setiap elemen dalam array adalah struktur NDIS_NIC_SWITCH_INFO .

Catatan Jika NumElements diatur ke nol, anggota ini diabaikan.

NumElements

Nilai ULONG yang menentukan jumlah elemen yang mengikuti struktur NDIS_NIC_SWITCH_INFO_ARRAY .

ElementSize

Nilai ULONG yang menentukan ukuran, dalam byte, dari setiap elemen yang mengikuti struktur NDIS_NIC_SWITCH_INFO_ARRAY .

Keterangan

NDIS mengembalikan struktur NDIS_NIC_SWITCH_INFO_ARRAY dengan cara berikut:

Saat NDIS menangani permintaan kueri OID OID_NIC_SWITCH_ENUM_SWITCHES, NDIS mengembalikan penunjuk ke struktur NDIS_NIC_SWITCH_INFO_ARRAY di anggota InformationBufferdari NDIS_OID_REQUEST.
Ketika NDIS memanggil fungsi ProtocolBindAdapterEx , NDIS meneruskan penunjuk ke struktur NDIS_BIND_PARAMETERS dalam parameter BindParameters . NDIS menetapkan anggota NicSwitchArray dari struktur NDIS_BIND_PARAMETERS ke penunjuk ke struktur NDIS_NIC_SWITCH_INFO_ARRAY .
Saat NDIS memanggil fungsi FilterAttach , NDIS meneruskan penunjuk ke struktur NDIS_FILTER_ATTACH_PARAMETERS dalam parameter AttachParameters . NDIS menetapkan anggota NicSwitchArray dari struktur NDIS_FILTER_ATTACH_PARAMETERS ke penunjuk ke struktur NDIS_NIC_SWITCH_INFO_ARRAY .

Setiap elemen dalam array yang mengikuti struktur NDIS_NIC_SWITCH_INFO_ARRAY adalah struktur NDIS_NIC_SWITCH_INFO .

Catatan Dimulai dengan NDIS 6.30, hanya NDIS_NIC_SWITCH_INFO yang menjelaskan informasi tentang sakelar adaptor jaringan default yang dikembalikan melalui permintaan kueri OID OID_NIC_SWITCH_ENUM_SWITCHES.