Função ExAcquireFastMutex (wdm.h)

A rotina ExAcquireFastMutex adquire o mutex rápido fornecido com APCs para o thread atual desabilitado.

Sintaxe

void ExAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parâmetros

FastMutex

[in, out] Um ponteiro para um mutex rápido inicializado para o qual o chamador fornece o armazenamento.

Retornar valor

Nenhum

Comentários

ExAcquireFastMutex coloca o chamador em um estado de espera se o mutex rápido determinado não puder ser adquirido imediatamente. Caso contrário, o chamador recebe a propriedade do mutex rápido com APCs para o thread atual desabilitado até liberar o mutex rápido.

Use ExTryToAcquireFastMutex se o thread atual puder fazer outro trabalho antes de aguardar a aquisição do mutex fornecido.

Qualquer mutex rápido adquirido usando ExAcquireFastMutex ou ExTryToAcquireFastMutex 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 ExAcquireFastMutex devem estar em execução em IRQL <= APC_LEVEL. ExAcquireFastMutex define o IRQL como APC_LEVEL e o chamador continua a ser executado em APC_LEVEL após o retorno de ExAcquireFastMutex . ExAcquireFastMutex salva o IRQL anterior do chamador no mutex, no entanto, e esse IRQL é restaurado quando o chamador invoca 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

ExAcquireFastMutexUnsafe

ExInitializeFastMutex

ExReleaseFastMutex

ExTryToAcquireFastMutex