EVT_NET_ADAPTER_CREATE_RXQUEUE fungsi panggilan balik (netadapter.h)

Artikel
05/23/2024

Implementasi driver klien dari fungsi panggilan balik peristiwa EvtNetAdapterCreateRxQueue yang menyiapkan antrean terima (Rx).

Sintaks

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

Parameter

[_In_] Adapter

Objek adaptor jaringan yang dibuat klien dalam panggilan sebelumnya ke NetAdapterCreate.

[_Inout_] RxQueueInit

Penunjuk ke struktur NETRXQUEUE_INIT yang dialokasikan NetAdapterCx. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Nilai kembali

Jika operasi berhasil, fungsi panggilan balik harus mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, kode kesalahan NTSTATUS yang sesuai.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EVT_NET_ADAPTER_CREATE_RXQUEUE, driver klien harus memanggil NetAdapterCreate.

Struktur NETRXQUEUE_INIT adalah struktur buram yang didefinisikan dan dialokasikan oleh NetAdapterCx, mirip dengan WDFDEVICE_INIT.

Dalam panggilan balik ini, driver klien mungkin memanggil NetRxQueueInitGetQueueId untuk mengambil pengidentifikasi antrean terima untuk disiapkan. Selanjutnya, klien memanggil NetRxQueueCreate untuk mengalokasikan antrean. Jika NetRxQueueCreate gagal, fungsi panggilan balik EvtNetAdapterCreateRxQueue harus mengembalikan kode kesalahan.

NetAdapterCx memanggil EvtNetAdapterCreateRxQueue di bagian paling akhir urutan power-up.

Untuk contoh kode penerapan fungsi panggilan balik ini, lihat Mengirimkan dan menerima antrean.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.29
Versi UMDF minimum	2.33
Header	netadapter.h (termasuk netadaptercx.h)
IRQL	PASSIVE_LEVEL

Bagikan melalui