Função ExInitializeFastMutex (wdm.h)

Artigo
02/27/2024

A rotina ExInitializeFastMutex inicializa uma variável mutex rápida, usada para sincronizar o acesso mutuamente exclusivo por um conjunto de threads com um recurso compartilhado.

Sintaxe

void ExInitializeFastMutex(
  [out] PFAST_MUTEX FastMutex
);

Parâmetros

[out] FastMutex

Um ponteiro para uma estrutura de FAST_MUTEX alocada pelo chamador, que representa o mutex rápido, no pool de memória nãopagado. A alocação deve ser alinhada a 4 bytes em plataformas de 32 bits e alinhada a 8 bytes em plataformas de 64 bits.

Retornar valor

Nenhum

Comentários

ExInitializeFastMutex deve ser chamado antes que quaisquer chamadas para outras rotinas ExXxxFastMutex ocorram.

Embora o chamador forneça o armazenamento para o mutex rápido fornecido, a estrutura de FAST_MUTEX é opaca: ou seja, seus membros são reservados para uso do sistema.

Para melhorar o desempenho, use as rotinas ExXxxFastMutex em vez das rotinas KeXxxMutex . No entanto, um mutex rápido não pode ser adquirido recursivamente, como um mutex de kernel pode.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL