IO_CSQ_ACQUIRE_LOCK fungsi panggilan balik (wdm.h)
Rutinitas CsqAcquireLock digunakan oleh sistem untuk memperoleh kunci untuk antrean IRP yang diterapkan driver dan aman untuk pembatalan.
Sintaks
IO_CSQ_ACQUIRE_LOCK IoCsqAcquireLock;
void IoCsqAcquireLock(
[in] PIO_CSQ Csq,
[out] PKIRQL Irql
)
{...}
Parameter
[in] Csq
Arahkan ke struktur IO_CSQ untuk antrean IRP yang batal aman.
[out] Irql
Penunjuk ke variabel yang dapat digunakan rutinitas CsqAcquireLock untuk menyimpan IRQL saat ini. Sistem melewati nilai tersimpan CsqReleaseLock saat melepaskan kunci.
Nilai kembali
Tidak ada
Keterangan
Driver menentukan rutinitas CsqAcquireLock untuk antrean IRP yang aman batal ketika menginisialisasi struktur IO_CSQ antrean. Driver menentukan rutinitas sebagai parameter CsqAcquireLock dari IoCsqInitialize atau IoCsqInitializeEx saat menginisialisasiIO_CSQ. Untuk informasi selengkapnya, lihat Antrean IRP Batal-Aman.
Sistem memanggil rutinitas ini untuk memperoleh kunci pada antrean IRP driver sebelum mencoba memasukkan atau menghapus IRP dari antrean. Sistem memanggil rutinitas CsqReleaseLock untuk melepaskan kunci.
Jika driver menggunakan kunci putar untuk menerapkan penguncian untuk antrean, driver harus menyimpan IRQL saat ini ketika melepaskan kunci putar. Sistem meneruskan pointer ke variabel IRQL yang dapat digunakan driver untuk menyimpan IRQL saat ini. Sistem meneruskan nilai yang disimpan sebagai parameter Irql ke CsqReleaseLock saat melepaskan kunci. Jika tidak, driver dapat mengabaikan parameter Irql . Untuk informasi tentang kunci spin, lihat Spin Locks.
Driver dapat menggunakan mekanisme penguncian apa pun untuk mengunci antrean, seperti mutex. Untuk informasi selengkapnya tentang mutex, lihat Objek Mutex.
Contoh
Untuk menentukan rutinitas panggilan balik CsqAcquireLock , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi panggilan balik membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.
Misalnya, untuk menentukan rutinitas panggilan balik CsqAcquireLock yang diberi nama MyCsqAcquireLock
, gunakan jenis IO_CSQ_ACQUIRE_LOCK seperti yang ditunjukkan dalam contoh kode ini:
IO_CSQ_ACQUIRE_LOCK MyCsqAcquireLock;
Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:
_Use_decl_annotations_
VOID
MyCsqAcquireLock(
PIO_CSQ Csq,
PKIRQL Irql
)
{
// Function body
}
Jenis fungsi IO_CSQ_ACQUIRE_LOCK ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan _Use_decl_annotations_
anotasi ke definisi fungsi Anda. Anotasi _Use_decl_annotations_
memastikan bahwa anotasi yang diterapkan ke jenis fungsi IO_CSQ_ACQUIRE_LOCK dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver WDM. Untuk informasi tentang _Use_decl_annotations_
, lihat Perilaku Fungsi Anotasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
IRQL | Lihat bagian Keterangan. |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk