Função KeTryToAcquireGuardedMutex (wdm.h)
A rotina KeTryToAcquireGuardedMutex adquire um mutex protegido, se disponível.
Sintaxe
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
Parâmetros
[in, out] Mutex
Ponteiro para a estrutura de KGUARDED_MUTEX para o mutex protegido.
Valor de retorno
KeTryToAcquireGuardedMutex retornará verdadeiro se o mutex for adquirido e FALSE caso contrário.
Observações
Use KeReleaseGuardedMutex para liberar o mutex.
KeTryToAcquireGuardedMutex retorna imediatamente, independentemente de poder adquirir o mutex. Use KeAcquireGuardedMutex para colocar o thread de chamada em um estado de espera até que o mutex fique disponível.
Um thread que chama KeTryToAcquireGuardedMutex entra implicitamente em uma região protegida, em que todas as APCs estão desabilitadas. Eles permanecem desabilitados até que o thread libere o mutex com KeReleaseGuardedMutex.
Para obter mais informações sobre mutexes protegidos, consulte Mutexes Rápidos e Mutexes Protegidos.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Server 2003 e versões posteriores do Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm) |