Windows Win32Sincronizaçãokernel32.dll
CreateEventW
Cria (ou abre, se nomeado) um objeto de evento, usado para sinalizar que algo aconteceu.
Descrição
Equivalente funcional aproximado do `eventfd`/futex do Linux para sinalização entre threads, mas — como mutex — sempre um objeto do kernel com HANDLE. Pode ser manual-reset (fica sinalizado até ser explicitamente resetado) ou auto-reset (reseta automaticamente após acordar uma thread).
Header:
synchapi.hDLL: kernel32.dllNative API: NtCreateEventAssinatura
HANDLE CreateEventW(
LPSECURITY_ATTRIBUTES lpEventAttributes,
BOOL bManualReset,
BOOL bInitialState,
LPCWSTR lpName
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| lpEventAttributes | LPSECURITY_ATTRIBUTES | Atributos de segurança, ou NULL. |
| bManualReset | BOOL | TRUE para reset manual, FALSE para auto-reset. |
| bInitialState | BOOL | Estado inicial: sinalizado (TRUE) ou não (FALSE). |
| lpName | LPCWSTR | Nome opcional, para compartilhamento entre processos. |
Valor de retorno
Um handle para o evento em sucesso; NULL em erro (consulte GetLastError).
Códigos de erro (GetLastError)
- ERROR_ALREADY_EXISTS(183)
- Não é possível criar um arquivo já existente.
- ERROR_ACCESS_DENIED(5)
- Acesso negado.
Relacionadas
Equivalente em Linux x86_64