IWDFObject::Metode AcquireLock (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode AcquireLock mencegah kerangka kerja memanggil metode antarmuka yang didaftarkan driver.
Sintaks
void AcquireLock();
Mengembalikan nilai
Tidak ada
Keterangan
Jika driver mengonfigurasi dirinya sendiri untuk menggunakan skema penguncian AcquireLock , kerangka kerja secara otomatis memperoleh kunci "presentasi" sebelum memanggil ke driver. (Untuk informasi selengkapnya tentang skema penguncian ini, lihat Menentukan Mode Sinkronisasi Panggilan Balik.) Metode AcquireLock dan IWDFObject::ReleaseLock memperoleh dan melepaskan kunci presentasi. Objek perangkat kerangka kerja dan objek antrean I/O kerangka kerja saat ini mendukung metode AcquireLock .
Driver memanggil metode AcquireLock untuk memanipulasi objeknya yang dibuat dari antarmuka panggilan baliknya di luar cakupan panggilan balik dengan cara yang aman untuk utas. Metode AcquireLock mewakili fitur lanjutan dari kerangka kerja yang tidak akan digunakan sebagian besar driver karena penggunaan yang tidak tepat dapat mengakibatkan kebuntuan.
Kode yang tidak disinkronkan dapat memanggil AcquireLock. Driver harus memanggil objek yang cocok dengan cakupan sinkronisasinya.
Contoh
Untuk contoh kode tentang cara menggunakan metode AcquireLock , lihat IWDFDevice::SetPnpState.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1,5 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |