KeTryToAcquireGuardedMutex 함수(wdm.h)
KeTryToAcquireGuardedMutex 루틴은 사용 가능한 경우 보호된 뮤텍스를 획득합니다.
구문
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
매개 변수
[in, out] Mutex
보호된 뮤텍스의 KGUARDED_MUTEX 구조체에 대한 포인터입니다.
반환 값
KeTryToAcquireGuardedMutex 는 뮤텍스를 획득하면 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다.
설명
KeReleaseGuardedMutex를 사용하여 뮤텍스를 해제합니다.
KeTryToAcquireGuardedMutex는 뮤텍스를 획득할 수 있는지 여부에 관계없이 즉시 반환됩니다. KeAcquireGuardedMutex를 사용하여 뮤텍스를 사용할 수 있게 될 때까지 호출 스레드를 대기 상태로 전환합니다.
KeTryToAcquireGuardedMutex를 호출하는 스레드는 모든 APC가 사용하지 않도록 설정된 보호된 지역에 암시적으로 들어갑니다. 스레드가 KeReleaseGuardedMutex를 사용하여 뮤텍스를 해제할 때까지 비활성화된 상태로 유지됩니다.
보호된 뮤텍스에 대한 자세한 내용은 빠른 뮤텍스 및 보호된 뮤텍스를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Server 2003 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |