KeAcquireGuardedMutex 함수(wdm.h)

  • 아티클

KeAcquireGuardedMutex 루틴은 보호된 뮤텍스를 획득합니다.

구문

void KeAcquireGuardedMutex(
  PKGUARDED_MUTEX Mutex
);

매개 변수

Mutex

[in, out] 보호된 뮤텍스의 KGUARDED_MUTEX 구조체에 대한 포인터입니다. 이 구조체는 KeInitializeGuardedMutex를 사용하여 초기화되어야 합니다.

반환 값

없음

설명

KeReleaseGuardedMutex를 사용하여 KeAcquireGuardedMutex로 획득한 뮤텍스를 해제합니다.

뮤텍스를 사용할 수 있는 경우 KeAcquireGuardedMutex는 즉시 반환됩니다. 그렇지 않으면 뮤텍스를 사용할 수 있게 될 때까지 호출 스레드가 대기 상태로 설정됩니다. 뮤텍스를 사용할 수 없을 때 대기 상태를 입력하지 않도록 하려면 KeTryToAcquireGuardedMutex를 사용합니다.

KeAcquireGuardedMutex를 호출하는 스레드는 모든 APC가 사용하지 않도록 설정된 보호된 지역에 암시적으로 들어갑니다. 스레드가 KeReleaseGuardedMutex를 사용하여 뮤텍스를 해제할 때까지 비활성화된 상태로 유지됩니다.

보호된 뮤텍스를 재귀적으로 가져올 수 없습니다. 스레드가 KeAcquireGuardedMutex를 호출할 때 뮤텍스를 이미 보유하고 있는 경우 스레드는 교착 상태가 됩니다.

보호된 뮤텍스에 대한 자세한 내용은 빠른 뮤텍스 및 보호된 뮤텍스를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 서버 Windows Server 2003
머리글 wdm.h
IRQL <= APC_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm)

추가 정보

KGUARDED_MUTEX

KeReleaseGuardedMutex