Função KeInitializeMutex (wdm.h)

  • Artigo

A rotina KeInitializeMutex inicializa um objeto mutex, definindo-o como um estado sinalizado.

Sintaxe

void KeInitializeMutex(
  [out] PRKMUTEX Mutex,
  [in]  ULONG    Level
);

Parâmetros

[out] Mutex

Ponteiro para um objeto mutex, para o qual o chamador fornece o armazenamento. O armazenamento deve estar alinhado a 4 bytes em plataformas de 32 bits e alinhado a 8 bytes em plataformas de 64 bits.

[in] Level

Reservado. Os drivers definem isso como zero.

Retornar valor

Nenhum

Comentários

Para melhorar o desempenho, use mutexes rápidos ou mutexes protegidos. Para obter mais informações, consulte Alternativas a objetos Mutex.

O objeto mutex é inicializado com um estado inicial de sinalizado.

O armazenamento de um objeto mutex deve ser residente: na extensão do dispositivo de um objeto de dispositivo criado pelo driver, na extensão do controlador de um objeto controlador criado pelo driver ou no pool nãopagado alocado pelo chamador.

Para obter mais informações sobre objetos mutex, consulte Objetos Mutex.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualquer nível
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport)

Confira também

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject