ExTryToAcquireFastMutex 함수(wdm.h)

  • 아티클

ExTryToAcquireFastMutex 루틴은 가능한 경우 현재 스레드에 대한 APC를 사용하지 않도록 설정하여 지정된 빠른 뮤텍스를 획득합니다.

구문

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

매개 변수

FastMutex

[in, out] 현재 다른 스레드가 소유하지 않은 경우 획득할 빠른 뮤텍스에 대한 포인터입니다.

반환 값

ExTryToAcquireFastMutex 는 현재 스레드에 빠른 뮤텍스의 소유권이 부여되면 TRUE 를 반환합니다.

설명

지정된 빠른 뮤텍스가 현재 소유되지 않은 경우 ExTryToAcquireFastMutex 는 빠른 뮤텍스를 해제할 때까지 APC를 사용하지 않도록 설정된 현재 스레드에 대한 호출자 소유권을 제공합니다.

현재 스레드가 지정된 뮤텍스 획득을 기다려야 유용한 작업을 수행할 수 있는 경우 ExAcquireFastMutex 를 사용합니다.

ExTryToAcquireFastMutex 또는 ExAcquireFastMutex를 사용하여 획득한 모든 빠른 뮤텍스는 ExReleaseFastMutex와 함께 릴리스되어야 합니다.

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

ExTryToAcquireFastMutex의 호출자는 IRQL <= APC_LEVEL 실행되어야 합니다. ExTryToAcquireFastMutex 는 뮤텍스가 획득되면 IRQL을 APC_LEVEL 설정하고 ExTryToAcquireFastMutex 가 반환된 후에도 호출자가 APC_LEVEL 계속 실행됩니다. 그러나 ExTryToAcquireFastMutex는 성공한 경우 호출자의 이전 IRQL을 뮤텍스에 저장하고 호출자가 ExReleaseFastMutex를 호출할 때 해당 IRQL이 복원됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000
머리글 wdm.h
IRQL <= APC_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDDIs(storport), IrqlExApcLte1(wdm)

추가 정보

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex