Função ExTryToAcquireFastMutex (wdm.h)
A rotina ExTryToAcquireFastMutex adquire o mutex rápido fornecido, se possível, com APCs para o thread atual desabilitado.
Sintaxe
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Parâmetros
FastMutex
[in, out] Um ponteiro para o mutex rápido a ser adquirido se ele não pertence a outro thread no momento.
Retornar valor
ExTryToAcquireFastMutex retornará TRUE se o thread atual tiver a propriedade do mutex rápido.
Comentários
Se o mutex rápido fornecido não for sem proprietário no momento, ExTryToAcquireFastMutex fornecerá ao chamador a propriedade 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 fornecido 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 em 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 o retorno de ExTryToAcquireFastMutex . ExTryToAcquireFastMutex salva o IRQL anterior do chamador no mutex se tiver êxito, no entanto, e esse IRQL será restaurado quando o chamador chamar ExReleaseFastMutex.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 |
Cabeçalho | wdm.h |
IRQL | <= APC_LEVEL |
Regras de conformidade da DDI | HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm) |