Fungsi NetTxQueueCreate (nettxqueue.h)

Artikel
05/23/2024

Membuat objek antrean transmisi bersih.

Sintaks

NTSTATUS NetTxQueueCreate(
  [_Inout_]  NETTXQUEUE_INIT         *NetTxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *TxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Parameter

[_Inout_] NetTxQueueInit

Penunjuk ke struktur NETTXQUEUE_INIT yang diterima driver klien dalam EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil yang diinisialisasi. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES. Namun, jika driver klien menyediakan parameter ini, bidang ParentObject harus NULL.

[_In_] Configuration

Penunjuk ke struktur NET_PACKET_QUEUE_CONFIG yang dialokasikan penelepon.

[_Out_] PacketQueue

Penunjuk ke lokasi yang menerima handel ke objek antrean transmisi bersih baru.

Mengembalikan nilai

Fungsi mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini dapat mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Klien memanggil NetTxQueueCreate dari dalam fungsi panggilan balik peristiwa EVT_NET_ADAPTER_CREATE_TXQUEUE . Untuk informasi tentang menetapkan ruang konteks ke objek baru, lihat Ruang Konteks Objek Kerangka Kerja.

Objek NETPACKETQUEUE adalah objek WDF standar. Kerangka kerja mengelola penghapusannya, yang terjadi ketika objek NETADAPTER induk dihapus.

Persyaratan

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

Bagikan melalui