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)

Lihat juga

WDF_OBJECT_ATTRIBUTES

KeEnterCriticalRegion

WdfObjectReleaseLock