Fungsi IoCsqInitialize (wdm.h)

Artikel
03/01/2024

Rutinitas IoCsqInitialize menginisialisasi tabel pengiriman antrean IRP pembatalan-aman driver.

Sintaks

NTSTATUS IoCsqInitialize(
  [out] PIO_CSQ                       Csq,
  [in]  PIO_CSQ_INSERT_IRP            CsqInsertIrp,
  [in]  PIO_CSQ_REMOVE_IRP            CsqRemoveIrp,
  [in]  PIO_CSQ_PEEK_NEXT_IRP         CsqPeekNextIrp,
  [in]  PIO_CSQ_ACQUIRE_LOCK          CsqAcquireLock,
  [in]  PIO_CSQ_RELEASE_LOCK          CsqReleaseLock,
  [in]  PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);

Parameter

[out] Csq

Arahkan ke struktur IO_CSQ yang akan diinisialisasi oleh IoCsqInitialize.

[in] CsqInsertIrp

Arahkan ke fungsi CsqInsertIrp yang ditentukan driver untuk antrean IRP pembatalan-aman driver.

[in] CsqRemoveIrp

Arahkan ke fungsi CsqRemoveIrp yang ditentukan driver untuk antrean IRP pembatalan-aman driver.

[in] CsqPeekNextIrp

Arahkan ke fungsi CsqPeekNextIrp yang ditentukan driver untuk antrean IRP pembatalan-aman driver.

[in] CsqAcquireLock

Arahkan ke fungsi CsqAcquireLock yang ditentukan driver untuk antrean IRP pembatalan-aman driver.

[in] CsqReleaseLock

Arahkan ke fungsi CsqReleaseLock yang ditentukan driver untuk antrean IRP pembatalan-aman driver.

[in] CsqCompleteCanceledIrp

Arahkan ke fungsi CsqCompleteCanceledIrp yang ditentukan driver untuk antrean IRP yang aman untuk pembatalan driver.

Nilai kembali

Rutinitas ini mengembalikan STATUS_SUCCESS pada keberhasilan, atau kode kesalahan NTSTATUS yang sesuai pada kegagalan.

Keterangan

Rutinitas IoCsqInitialize menginisialisasi struktur IO_CSQ yang menjelaskan antrean IRP yang aman untuk pembatalan driver. Driver juga dapat menggunakan IoCsqInitializeEx untuk membuat antrean IRP dengan kemampuan yang diperluas. Untuk informasi selengkapnya, lihat Antrean IRP Batal-Aman.

Perhatikan bahwa rutinitas IoCsqXxx menggunakan anggota DriverContext[3] dari IRP untuk menyimpan informasi konteks IRP. Driver yang menggunakan rutinitas ini untuk mengantre runtime integrasi harus membiarkan anggota tersebut tidak digunakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi sistem operasi Windows yang lebih baru. Driver yang juga harus berfungsi untuk Windows 2000 dan Windows 98/Me dapat ditautkan ke Csq.lib untuk menggunakan rutinitas.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Tingkat apa pun