struktur NDIS_PROTOCOL_DRIVER_CHARACTERISTICS (ndis.h)

Artikel
05/23/2024

Untuk menentukan karakteristik drivernya, driver protokol menginisialisasi struktur NDIS_PROTOCOL_DRIVER_CHARACTERISTICS dan meneruskannya ke NDIS.

Sintaks

typedef struct _NDIS_PROTOCOL_DRIVER_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                     Header;
  UCHAR                                  MajorNdisVersion;
  UCHAR                                  MinorNdisVersion;
  UCHAR                                  MajorDriverVersion;
  UCHAR                                  MinorDriverVersion;
  ULONG                                  Flags;
  NDIS_STRING                            Name;
  SET_OPTIONS_HANDLER                    SetOptionsHandler;
  BIND_HANDLER_EX                        BindAdapterHandlerEx;
  UNBIND_HANDLER_EX                      UnbindAdapterHandlerEx;
  OPEN_ADAPTER_COMPLETE_HANDLER_EX       OpenAdapterCompleteHandlerEx;
  CLOSE_ADAPTER_COMPLETE_HANDLER_EX      CloseAdapterCompleteHandlerEx;
  NET_PNP_EVENT_HANDLER                  NetPnPEventHandler;
  UNINSTALL_PROTOCOL_HANDLER             UninstallHandler;
  OID_REQUEST_COMPLETE_HANDLER           OidRequestCompleteHandler;
  STATUS_HANDLER_EX                      StatusHandlerEx;
  RECEIVE_NET_BUFFER_LISTS_HANDLER       ReceiveNetBufferListsHandler;
  SEND_NET_BUFFER_LISTS_COMPLETE_HANDLER SendNetBufferListsCompleteHandler;
  DIRECT_OID_REQUEST_COMPLETE_HANDLER    DirectOidRequestCompleteHandler;
} NDIS_PROTOCOL_DRIVER_CHARACTERISTICS, *PNDIS_PROTOCOL_DRIVER_CHARACTERISTICS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_PROTOCOL_DRIVER_CHARACTERISTICS . Atur anggota Jenis struktur yang ditentukan Header ke NDIS_OBJECT_TYPE_PROTOCOL_DRIVER_CHARACTERISTICS.

Untuk menunjukkan versi struktur NDIS_PROTOCOL_DRIVER_CHARACTERISTICS , atur anggota Revisi ke salah satu nilai berikut:

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2

Menambahkan anggota DirectOidRequestCompleteHandler untuk NDIS 6.1.

Atur anggota Ukuran ke NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2.

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1

Versi asli untuk NDIS 6.0.

Atur anggota Ukuran ke NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1.

MajorNdisVersion

Versi utama pustaka NDIS yang digunakan driver protokol. Nilai saat ini adalah 0x06.

MinorNdisVersion

Versi NDIS minor. Berikut ini adalah pengaturan nilai versi minor yang tersedia.

Nilai	Makna
0	NDIS 6
20	NDIS 6.20
30	NDIS 6.30
40	NDIS 6.40
50	NDIS 6,50
51	NDIS 6,51
60	NDIS 6.60
70	NDIS 6,70
80	NDIS 6,80
81	NDIS 6,81
82	NDIS 6,82
83	NDIS 6,83
84	NDIS 6,84
85	NDIS 6,85
86	NDIS 6.86
87	NDIS 6,87
88	NDIS 6,88
89	NDIS 6,89

MajorDriverVersion

Dicadangkan untuk nomor versi utama driver protokol. Driver protokol dapat menentukan nilai apa pun yang mereka butuhkan.

MinorDriverVersion

Dicadangkan untuk nomor versi minor driver protokol. Driver protokol dapat menentukan nilai apa pun yang mereka butuhkan.

Flags

Bendera berikut didukung di NDIS 6.89 dan yang lebih tinggi:

Nilai	Makna
NDIS_PROTOCOL_DRIVER_UDP_RSC_NOT_SUPPORTED 0x00000008	Penolakan driver dari dukungan URO.

Di NDIS 6.88 ke bawah, Bendera disediakan untuk NDIS. Driver protokol harus mengatur anggota ini ke nol.

Name

String Unicode yang merupakan nama layanan driver protokol.

SetOptionsHandler

Titik entri untuk fungsi ProtocolSetOptions .

BindAdapterHandlerEx

Titik masuk untuk Fungsi ProtocolBindAdapterEx .

UnbindAdapterHandlerEx

Titik masuk untuk Fungsi ProtocolUnbindAdapterEx .

OpenAdapterCompleteHandlerEx

Titik masuk untuk Fungsi ProtocolOpenAdapterCompleteEx .

CloseAdapterCompleteHandlerEx

Titik masuk untuk Fungsi ProtocolCloseAdapterCompleteEx .

NetPnPEventHandler

Titik masuk fungsi ProtocolNetPnPEvent penelepon.

UninstallHandler

Titik masuk fungsi ProtocolUninstall penelepon, jika ada, atau NULL.

OidRequestCompleteHandler

Titik masuk penelepon Fungsi ProtocolOidRequestComplete .

StatusHandlerEx

Titik masuk fungsi ProtocolStatusEx penelepon, jika ada, atau NULL.

ReceiveNetBufferListsHandler

Titik masuk untuk Fungsi ProtocolReceiveNetBufferLists .

SendNetBufferListsCompleteHandler

Titik masuk untuk Fungsi ProtocolSendNetBufferListsComplete .

DirectOidRequestCompleteHandler

Titik masuk penelepon Fungsi ProtocolDirectOidRequestComplete . Ini adalah fungsi opsional. Atur titik masuk ini ke NULL jika driver protokol tidak mendukung antarmuka permintaan OID langsung.

Keterangan

Driver protokol memanggil Fungsi NdisRegisterProtocolDriver untuk mendaftarkan karakteristiknya, termasuk titik masuk default untuk fungsi driver protokolnya (ProtocolXxx). Driver protokol menginisialisasi struktur NDIS_PROTOCOL_DRIVER_CHARACTERISTICS dan meneruskan penunjuk ke struktur ini dalam parameter ProtocolCharacteristicsdari NdisRegisterProtocolDriver.