IO_CSQ_RELEASE_LOCK fungsi panggilan balik (wdm.h)

Artikel
07/02/2025

Rutinitas CsqReleaseLock digunakan oleh sistem untuk melepaskan kunci yang diperoleh menggunakan CsqAcquireLock.

Sintaksis

C++

IO_CSQ_RELEASE_LOCK IoCsqReleaseLock;

void IoCsqReleaseLock(
  [in] PIO_CSQ Csq,
  [in] KIRQL Irql
)
{...}

Parameter

[in] Csq

Arahkan penunjuk ke struktur IO_CSQ untuk antrean IRP batal-aman.

[in] Irql

Menentukan IRQL. Ini adalah nilai yang disimpan oleh CsqAcquireLock ketika kunci diperoleh.

Mengembalikan nilai

Tidak

Komentar

Driver menentukan rutinitas CsqReleaseLock untuk antrean IRP yang aman batal ketika menginisialisasi struktur IO_CSQ antrean. Driver menentukan rutinitas sebagai parameter CsqReleaseLock dari IoCsqInitialize atau IoCsqInitializeEx saat menginisialisasi IO_CSQ. Untuk informasi selengkapnya, lihat Antrean IRPCancel-Safe .

Sistem memanggil fungsi ini untuk merilis kunci yang diperoleh menggunakan CsqAcquireLock.

Jika driver menggunakan kunci putar untuk menerapkan penguncian untuk antrean, driver harus menyimpan IRQL saat ini ketika memperoleh kunci, dan menyediakan IRQL yang disimpan saat melepaskan kunci. Rutinitas CsqAcquireLock menyimpan IRQL saat ini, dan sistem meneruskan nilai yang disimpan sebagai parameter Irql ke CsqReleaseLock. 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 CsqReleaseLock, 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 CsqReleaseLock yang diberi nama MyCsqReleaseLock, gunakan jenis IO_CSQ_RELEASE_LOCK seperti yang ditunjukkan dalam contoh kode ini:

C++

IO_CSQ_RELEASE_LOCK MyCsqReleaseLock;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

C++

_Use_decl_annotations_
VOID 
 MyCsqReleaseLock(
    PIO_CSQ  Csq,
    KIRQL  Irql
    )
  {
      // Function body
  }

Jenis fungsi IO_CSQ_RELEASE_LOCK ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan dengan lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi _Use_decl_annotations_ ke definisi fungsi Anda. Anotasi _Use_decl_annotations_ memastikan bahwa anotasi yang diterapkan ke jenis fungsi IO_CSQ_RELEASE_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 Anotasi Perilaku Fungsi.