EVT_NET_ADAPTER_CREATE_TXQUEUE fungsi panggilan balik (netadapter.h)

Implementasi driver klien dari fungsi panggilan balik peristiwa EvtNetAdapterCreateTxQueue yang menyiapkan antrean transmisi (Tx).

Sintaks

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Parameter

[_In_] Adapter

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

[_Inout_] TxQueueInit

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

Mengembalikan nilai

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_TXQUEUE , driver klien harus memanggil NetAdapterCreate.

Struktur NETTXQUEUE_INIT adalah struktur buram yang ditentukan dan dialokasikan oleh NetAdapterCx, mirip dengan WDFDEVICE_INIT.

Dalam panggilan balik ini, driver klien mungkin memanggil NetTxQueueInitGetQueueId untuk mengambil pengidentifikasi antrean transmisi untuk disiapkan. Selanjutnya, klien memanggil NetTxQueueCreate untuk mengalokasikan antrean. Jika NetTxQueueCreate gagal, fungsi panggilan balik EvtNetAdapterCreateTxQueue harus mengembalikan kode kesalahan.

NetAdapterCx memanggil EvtNetAdapterCreateTxQueue di 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
Header	netadapter.h (termasuk netadaptercx.h)
IRQL	PASSIVE_LEVEL