Compartilhar via


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)

Confira também

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex