Fungsi WdfObjectAcquireLock (wdfsync.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfObjectAcquireLock memperoleh kunci sinkronisasi objek.
Sintaks
VOID WdfObjectAcquireLock(
_In_ WDFOBJECT Object
);
Parameter
[in] Object
Handel ke objek perangkat kerangka kerja atau objek antrean kerangka kerja.
Keterangan
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Driver dapat memanggil metode WdfObjectAcquireLock untuk memperoleh kunci sinkronisasi yang terkait dengan objek perangkat kerangka kerja tertentu atau objek antrean kerangka kerja. Metode tidak kembali sampai kunci diperoleh.
Ketika driver tidak lagi memerlukan kunci sinkronisasi objek, driver harus memanggil WdfObjectReleaseLock.
Jika driver menentukan WdfExecutionLevelPassive untuk anggota ExecutionLevel dari struktur WDF_OBJECT_ATTRIBUTES objek yang ditentukan, driver harus memanggil WdfObjectAcquireLock di IRQL <= APC_LEVEL. WdfObjectAcquireLock memperoleh mutex cepat dan kembali di IRQL pemanggil. (Dalam hal ini, WdfObjectAcquireLock juga memanggil KeEnterCriticalRegion sebelum mengembalikan sehingga APC kernel normal dinonaktifkan.)
Jika driver tidak menentukan WdfExecutionLevelPassive untuk anggota ExecutionLevel dari struktur WDF_OBJECT_ATTRIBUTES objek yang ditentukan, driver harus memanggil WdfObjectAcquireLock di IRQL <= DISPATCH_LEVEL. WdfObjectAcquireLock memperoleh kunci putar dan mengembalikan pada IRQL = DISPATCH_LEVEL.
Untuk informasi selengkapnya tentang kunci sinkronisasi, lihat Teknik Sinkronisasi untuk Driver Framework-Based.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Versi UMDF minimum | 2.0 |
| Header | wdfsync.h (termasuk Wdf.h) |
| IRQL | Lihat bagian Keterangan. |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |