Fungsi RxCreateRxContext (rxcontx.h)

Artikel
08/07/2023

RxCreateRxContext mengalokasikan struktur RX_CONTEXT baru dan menginisialisasi struktur data.

Sintaks

PRX_CONTEXT RxCreateRxContext(
  [in, optional] IN PIRP                 Irp,
  [in]           IN PRDBSS_DEVICE_OBJECT RxDeviceObject,
  [in]           IN ULONG                InitialContextFlags
);

Parameter

[in, optional] Irp

Penunjuk ke IRP untuk dienkapsulasi oleh struktur RX_CONTEXT ini.

[in] RxDeviceObject

Penunjuk ke objek perangkat tempat RX_CONTEXT dan IRP ini berlaku.

[in] InitialContextFlags

Kumpulan nilai awal untuk anggota Bendera dari struktur data RX_CONTEXT yang akan disimpan dalam struktur RX_CONTEXT. Nilai awal ini dapat berupa kombinasi dari enumerasi berikut:

RX_CONTEXT_FLAG_WAIT

Ketika nilai ini diatur, IRP tidak boleh diposting untuk dieksekusi nanti oleh proses sistem file, tetapi harus menunggu selesai.

RX_CONTEXT_FLAG_MUST_SUCCEED

Ketika nilai ini diatur, operasi harus berhasil. Nilai ini saat ini tidak digunakan oleh RDBSS, tetapi dapat digunakan oleh driver pengalih mini jaringan.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Ketika nilai ini diatur, operasi harus berhasil untuk operasi non-pemblokiran. Nilai ini saat ini tidak digunakan oleh RDBSS, tetapi dapat digunakan oleh driver pengalih mini jaringan.

Nilai kembali

RxCreateRxContext mengembalikan penunjuk ke struktur data RX_CONTEXT yang dialokasikan pada keberhasilan atau pointer NULL pada kegagalan.

Keterangan

RxCreateRxContext memanggil RxInitializeContext untuk menginisialisasi struktur RX_CONTEXT yang baru dibuat sebelum kembali.

RxCreateRxContext mengalokasikan memori kumpulan non-halaman saat membuat struktur data RX_CONTEXT baru dan mengatur nilai berikut di anggota Bendera RX_CONTEXT:

Ketika nilai ini diatur, struktur RX_CONTEXT dialokasikan dari memori kumpulan non-halaman.