WdfObjectAcquireLock 함수(wdfsync.h)
[KMDF 및 UMDF에 적용]
WdfObjectAcquireLock 메서드는 개체의 동기화 잠금을 획득합니다.
통사론
VOID WdfObjectAcquireLock(
_In_ WDFOBJECT Object
);
매개 변수
[in] Object
프레임워크 디바이스 개체 또는 프레임워크 큐 개체에 대한 핸들입니다.
반환 값
없음
발언
드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.
드라이버는 WdfObjectAcquireLock 메서드를 호출하여 지정된 프레임워크 디바이스 개체 또는 프레임워크 큐 개체와 연결된 동기화 잠금을 가져올 수 있습니다. 잠금을 획득할 때까지 메서드가 반환되지 않습니다.
드라이버에 개체의 동기화 잠금이 더 이상 필요하지 않은 경우 WdfObjectReleaseLock호출해야 합니다.
지정된 개체의 WDF_OBJECT_ATTRIBUTES 구조체에서 ExecutionLevel 멤버에 대해 WdfExecutionLevelPassive 지정한 경우 드라이버는 IRQL <= APC_LEVEL WdfObjectAcquireLock 호출해야 합니다. WdfObjectAcquireLock빠른 뮤텍스 획득하고 호출자의 IRQL에서 반환합니다. (이 경우 WdfObjectAcquireLockKeEnterCriticalRegion 호출하여 일반 커널 APC 사용하지 않도록 설정합니다.
드라이버가 지정된 개체의 WDF_OBJECT_ATTRIBUTES 구조체의 ExecutionLevel 멤버에 WdfExecutionLevelPassive 지정하지 경우 드라이버는 IRQL <= DISPATCH_LEVEL WdfObjectAcquireLock 호출해야 합니다. WdfObjectAcquireLock스핀 잠금 획득하고 IRQL = DISPATCH_LEVEL 반환합니다.
동기화 잠금에 대한 자세한 내용은 Framework-Based 드라이버 대한동기화 기술을 참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 헤더 | wdfsync.h(Wdf.h 포함) |
| IRQL | 설명 섹션을 참조하세요. |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |