Função ExTryToAcquireFastMutex (wdm.h)
A rotina ExTryToAcquireFastMutex adquire o mutex rápido especificado, se possível, com APCs para o thread atual desabilitado.
Sintaxe
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Parâmetros
FastMutex
[dentro, fora] Um ponteiro para o mutex rápido a ser adquirido se ele não pertence atualmente a outro thread.
Valor de retorno
ExTryToAcquireFastMutex retornará verdadeiro se o thread atual tiver a propriedade do mutex rápido.
Observações
Se o mutex rápido determinado não for semeado no momento, ExTryToAcquireFastMutex fornecerá a propriedade do chamador com APCs para o thread atual desabilitado até que ele libere o mutex rápido.
Use exAcquireFastMutex se o thread atual precisar aguardar a aquisição do mutex determinado antes que ele possa fazer um trabalho útil.
Qualquer mutex rápido adquirido com ExTryToAcquireFastMutex ou ExAcquireFastMutex deve ser lançado com exReleaseFastMutex.
Para obter mais informações sobre mutexes rápidos, consulte Mutexes Rápidos e Mutexes Protegidos.
Os chamadores de ExTryToAcquireFastMutex devem estar em execução no IRQL <= APC_LEVEL. ExTryToAcquireFastMutex define o IRQL como APC_LEVEL se o mutex for adquirido e o chamador continuar a ser executado em APC_LEVEL após ExTryToAcquireFastMutex retorna. ExTryToAcquireFastMutex salva o IRQL anterior do chamador no mutex se bem-sucedido, no entanto, e esse IRQL é restaurado quando o chamador chama ExReleaseFastMutex.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| cabeçalho | wdm.h |
| IRQL | <= APC_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlExApcLte1(wdm) |