Fungsi NetRxQueueCreate (netrxqueue.h)

  • Artikel

Membuat objek antrean penerimaan bersih.

Sintaks

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Parameter

[_Inout_] NetRxQueueInit

Penunjuk ke struktur NETRXQUEUE_INIT yang diterima driver klien dalam fungsi panggilan balik EVT_NET_ADAPTER_CREATE_RXQUEUE .

[_In_opt_] RxQueueAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan dan diinisialisasi penelepon. 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 penerima bersih baru.

Nilai kembali

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

Keterangan

Klien memanggil NetRxQueueCreate dari dalam fungsi panggilan balik peristiwa EVT_NET_ADAPTER_CREATE_RXQUEUE . 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
Header netrxqueue.h (termasuk netadaptercx.h)
Pustaka NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL