Makro IoInitializeRemoveLock (wdm.h)

  • Artikel

Rutinitas IoInitializeRemoveLock menginisialisasi kunci hapus untuk objek perangkat.

Sintaks

void IoInitializeRemoveLock(
  [in]  Lock,
  [in]  Tag,
  [in]  Maxmin,
  [in]  HighWater
);

Parameter

[in] Lock

Penunjuk ke struktur IO_REMOVE_LOCK yang disediakan penelepon yang diinisialisasi rutinitas ini dengan informasi tentang kunci, termasuk penghitung dan peristiwa sinkronisasi. Penulis driver harus mengalokasikan struktur ini sebagai bagian dari ekstensi perangkat objek perangkat.

[in] Tag

Menentukan tag untuk mengidentifikasi pembuat kunci. Penulis driver biasanya menggunakan string 4 karakter, yang ditentukan dalam urutan terbalik, seperti tag yang digunakan untuk ExAllocatePoolWithTag.

Sistem I/O menggunakan parameter ini jika Pemverifikasi Driver diaktifkan. Pemanggil harus selalu menyediakan nilai tag bukan nol untuk parameter ini.

[in] Maxmin

Menentukan jumlah menit maksimum kunci ini harus ditahan. Nilai nol berarti tidak ada batasan. Nilai ini biasanya digunakan selama penelusuran kesalahan untuk mengidentifikasi rutinitas driver yang menahan kunci lebih lama dari yang diharapkan.

Sistem I/O menggunakan parameter ini jika Pemverifikasi Driver diaktifkan.

[in] HighWater

Menentukan jumlah maksimum akuisisi terutang yang diizinkan pada kunci. Gunakan 0 untuk menentukan tidak ada maksimum. HighWatermark harus <= 0x7FFFFFFF.

Sistem I/O menggunakan parameter ini jika Pemverifikasi Driver diaktifkan.

Nilai kembali

Tidak ada

Keterangan

Driver dapat menggunakan kunci hapus untuk melacak operasi I/O yang luar biasa pada perangkat dan untuk menentukan kapan driver dapat menghapus objek perangkatnya sebagai respons terhadap permintaan IRP_MN_REMOVE_DEVICE .

Sebelum memanggil IoInitializeRemoveLock, driver harus mengalokasikan struktur IO_REMOVE_LOCK dalam ekstensi perangkatnya. Driver biasanya memanggil IoInitializeRemoveLock dalam rutinitas AddDevice-nya , ketika driver menginisialisasi ekstensi perangkat lainnya untuk objek perangkat.

Setelah rutinitas IoReleaseRemoveLockAndWait kembali, driver harus mempertimbangkan perangkat berada dalam keadaan di mana perangkat siap untuk dihapus dan tidak dapat melakukan operasi I/O. Oleh karena itu, driver tidak boleh memanggil IoInitializeRemoveLock untuk menginisialisasi ulang kunci hapus. Pelanggaran aturan ini saat driver sedang diverifikasi oleh Driver Verifier akan mengakibatkan pemeriksaan bug.

Karena driver menyimpan struktur IO_REMOVE_LOCK dalam ekstensi perangkat objek perangkat, kunci hapus dihapus ketika driver menghapus ekstensi perangkat sebagai bagian dari pemrosesan permintaan IRP_MN_REMOVE_DEVICE .

Untuk informasi selengkapnya, lihat Menggunakan Hapus Kunci.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Lihat juga

IoAcquireRemoveLock

IoInitializeRemoveLock

IoReleaseRemoveLock

IoReleaseRemoveLockAndWait