PulseEvent
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função fornece uma única operação que define como sinalizado o estado do objeto de evento especificado e, em seguida, redefine-lo para não sinalizado após soltar o apropriado número de segmentos de espera.
Syntax
BOOL PulseEvent(
HANDLE hEvent
);
Parameters
- hEvent
[no] Identificador para o objeto evento. A função CreateEvent retorna esse identificador.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Para um manual-redefinir evento objeto, todos os segmentos de espera que pode ser lançado imediatamente são lançados. Em seguida, a função redefine estado do objeto de evento para não sinalizado e retorna.
Para uma auto-redefinir evento objeto, a função redefine o estado para não sinalizado e retorna após lançando um único segmento em espera, mesmo se múltiplo segmentos estão aguardando.
Se nenhum segmento está aguardando nenhum segmento pode ser lançado imediatamente, ou PulseEvent simplesmente define estado do objeto de evento para não sinalizado e retorna.
Para um segmento usando o múltiplo-objeto esperar funções aguardar para todos os objetos a ser especificado sinalizado, PulseEvent Pode definir estado do objeto de evento para sinalizado e redefinir que não sinalizado sem fazendo com que a função de espera para retornar. Isso acontece se não todos os objetos especificados são simultaneamente sinalizado.
Cada tipo objeto, such as memória mapas, semáforos, eventos, mensagem filas, exclusões mútuas e timers de monitoração, tem sua própria separar espaço para nome. Esvaziar seqüências de caracteres, " ", são tratados como nomeado objetos. Em plataformas com base em Área de trabalho Windows, sincronização objetos todos compartilhar o mesmo namespace.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Synchronization Functions
CreateEvent
ResetEvent
OpenEvent
SetEvent
WaitForSingleObject