struktur NDIS_OPEN_PARAMETERS (ndis.h)

Artikel
03/08/2023

Struktur NDIS_OPEN_PARAMETERS menentukan parameter terbuka saat driver protokol memanggil fungsi NdisOpenAdapterEx .

Sintaks

typedef struct _NDIS_OPEN_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  PNDIS_STRING       AdapterName;
  PNDIS_MEDIUM       MediumArray;
  UINT               MediumArraySize;
  PUINT              SelectedMediumIndex;
  PNET_FRAME_TYPE    FrameTypeArray;
  UINT               FrameTypeArraySize;
} NDIS_OPEN_PARAMETERS, *PNDIS_OPEN_PARAMETERS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_OPEN_PARAMETERS. Atur anggota Jenis struktur yang ditentukan Header ke NDIS_OBJECT_TYPE_OPEN_PARAMETERS, anggota Revisi ke NDIS_OPEN_PARAMETERS_REVISION_1, dan anggota Ukuran ke NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

String Unicode yang berisi nama adaptor miniport yang diteruskan NDIS ke ProtocolBindAdapterEx di anggota AdapterName parameter BindParameters . Nama ini dapat mengidentifikasi adaptor fisik (yaitu, NIC) atau adaptor virtual yang terkait dengan driver perantara.

MediumArray

Penunjuk ke array nilai NdisMediumXxx yang mencantumkan jenis media yang dapat didukung pemanggil. Daftar ini adalah subset dari jenis NDIS_MEDIUM .

MediumArraySize

Jumlah elemen dalam anggota MediumArray .

SelectedMediumIndex

Penunjuk ke variabel UINT yang disediakan driver yang berisi indeks ke dalam array MediumArray . NDIS menulis indeks ini yang mengidentifikasi jenis media yang digunakan driver yang mendasar.

FrameTypeArray

Penunjuk ke array nilai NET_FRAME_TYPE, menentukan jenis bingkai yang Anda inginkan untuk diterima driver protokol. Jenis bingkai adalah nilai USHORT yang mengikuti tujuan dan alamat MAC sumber dalam bingkai Ethernet. Di hadapan tag VLAN, nilai ini mengikuti tujuan, alamat MAC sumber, dan tag VLAN. NET_FRAME_TYPE didefinisikan sebagai berikut:

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

Catatan NDIS menggunakan nilai jenis bingkai yang disediakan driver protokol dalam array ini sebagai petunjuk untuk mengoptimalkan indikasi terima yang dikirim NDIS ke driver protokol. NDIS tidak menjamin bahwa driver protokol hanya akan menerima paket dengan jenis bingkai yang cocok dengan jenis dalam array.

FrameTypeArraySize

Jumlah elemen dalam anggota FrameTypeArray . Angka ini harus sama dengan atau kurang dari NDIS_MAX_FRAME_TYPES_PER_OPEN.