Função KeAcquireGuardedMutex (wdm.h)
A rotina de KeAcquireGuardedMutex adquire um mutex protegido.
Sintaxe
void KeAcquireGuardedMutex(
PKGUARDED_MUTEX Mutex
);
Parâmetros
Mutex
[dentro, fora] Ponteiro para a estrutura KGUARDED_MUTEX para o mutex protegido. Essa estrutura deve ter sido inicializada com KeInitializeGuardedMutex.
Valor de retorno
Nenhum
Observações
Use KeReleaseGuardedMutex para lançar um mutex adquirido com KeAcquireGuardedMutex.
Se o mutex estiver disponível, KeAcquireGuardedMutex retornará imediatamente. Caso contrário, o thread de chamada será colocado em um estado de espera até que o mutex fique disponível. Para evitar entrar em um estado de espera quando o mutex não estiver disponível, use KeTryToAcquireGuardedMutex.
Um thread que chama KeAcquireGuardedMutex 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.
Um mutex protegido não pode ser adquirido recursivamente: se um thread já estiver segurando o mutex quando ele chamar KeAcquireGuardedMutex, o thread será deadlock.
Para obter mais informações sobre mutexes protegidos, consulte Mutexes Rápidos e Mutexes Protegidos.
Requisitos
| Requisito | Valor |
|---|---|
| servidor com suporte mínimo | Windows Server 2003 |
| cabeçalho | wdm.h |
| IRQL | <= APC_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm) |