WdfObjectAcquireLock 함수(wdfsync.h)

[KMDF 및 UMDF에 적용]

WdfObjectAcquireLock 메서드는 개체의 동기화 잠금을 획득합니다.

구문

VOID WdfObjectAcquireLock(
  _In_ WDFOBJECT Object
);

매개 변수

[in] Object

프레임워크 디바이스 개체 또는 프레임워크 큐 개체에 대한 핸들입니다.

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

드라이버는 WdfObjectAcquireLock 메서드를 호출하여 지정된 프레임워크 디바이스 개체 또는 프레임워크 큐 개체와 연결된 동기화 잠금을 획득할 수 있습니다. 메서드는 잠금을 획득할 때까지 반환되지 않습니다.

드라이버에 더 이상 개체의 동기화 잠금이 필요하지 않은 경우 WdfObjectReleaseLock을 호출해야 합니다.

드라이버가 지정된 개체의 WDF_OBJECT_ATTRIBUTES 구조체의 ExecutionLevel 멤버에 대해 WdfExecutionLevelPassive를 지정한 경우 드라이버는 IRQL <= APC_LEVELWdfObjectAcquireLock을 호출해야 합니다. WdfObjectAcquireLock 은 빠른 뮤텍스 를 획득하고 호출자의 IRQL에서 를 반환합니다. (이 경우 WdfObjectAcquireLock은 일반 커널 APC를 사용하지 않도록 설정되도록 반환하기 전에 KeEnterCriticalRegion도 호출합니다.)

드라이버가 지정된 개체의 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)

추가 정보

WDF_OBJECT_ATTRIBUTES

KeEnterCriticalRegion

WdfObjectReleaseLock