Função ExReleaseFastMutex (wdm.h)

Artigo
03/05/2024

A rotina ExReleaseFastMutex libera a propriedade de um mutex rápido que foi adquirido com ExAcquireFastMutex ou ExTryToAcquireFastMutex.

Sintaxe

void ExReleaseFastMutex(
  PFAST_MUTEX FastMutex
);

Parâmetros

FastMutex

[in, out] Um ponteiro para o mutex rápido a ser liberado.

Retornar valor

Nenhum

Comentários

ExReleaseFastMutex libera a propriedade do mutex rápido fornecido e define o IRQL como o valor em que o chamador estava sendo executado antes de chamar ExAcquireFastMutex. Se o IRQL anterior for menor que APC_LEVEL, a entrega de APCs para o thread atual será reabilitada.

É um erro de programação chamar ExReleaseFastMutex com um FastMutex adquirido usando ExAcquireFastMutexUnsafe. Os drivers devem liberar um mutex rápido do mesmo thread que o adquiriu. Mutexes rápidos devem ser liberados na ordem oposta da ordem em que foram adquiridos.

Para obter mais informações sobre mutexes rápidos, consulte Mutexes rápidos e mutexes protegidos.

Os chamadores de ExReleaseFastMutex devem estar em execução em IRQL = APC_LEVEL. Na maioria dos casos, o IRQL já será definido como APC_LEVEL antes que ExReleaseFastMutex seja chamado porque ExAcquireFastMutex já definiu o IRQL como APC_LEVEL automaticamente. No entanto, se o chamador alterar o IRQL após o retorno de ExAcquireFastMutex , o chamador deverá definir explicitamente o IRQL como APC_LEVEL antes de chamar ExReleaseFastMutex.