Partilhar via


Função KeInitializeMutex (wdm.h)

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 ser alinhado de 4 bytes em plataformas de 32 bits e alinhado de 8 bytes em plataformas de 64 bits.

[in] Level

Reservado. Os drivers definem isso como zero.

Valor de retorno

Nenhum

Observações

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

O objeto mutex é inicializado com um estado inicial de sinalização.

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 de 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
de cliente com suporte mínimo Disponível a partir do Windows 2000.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL Qualquer nível
regras de conformidade de DDI HwStorPortProhibitedDIs(storport)

Consulte também

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject