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 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) |