Classe do evento

Um evento de redefinição manual que está explicitamente ciente do Concurrency Runtime.

Sintaxe

class event;

Members

Construtores Públicos

Nome	Description
~evento Destruidor	Destrói um evento.

Métodos Públicos

Nome	Description
redefinir	Redefine o evento para um estado não sinalizado.
set	Sinaliza o evento.
aguarde	Aguarda que o evento seja sinalizado.
wait_for_multiple	Aguarda que vários eventos sejam sinalizados.

Constantes Públicas

Nome	Description
timeout_infinite	Valor que indica que uma espera nunca deve expirar.

Observações

Para obter mais informações, consulte Estruturas de dados de sincronização.

Hierarquia de herança

event

Requerimentos

Cabeçalho: concrt.h

Namespace: simultaneidade

evento

Constrói um novo evento.

_CRTIMP event();

~evento

Destrói um evento.

~event();

Observações

Espera-se que não haja threads aguardando o evento quando o destruidor for executado. Permitir que o evento seja destruído com threads ainda aguardando resulta em comportamento indefinido.

redefinir

Redefine o evento para um estado não sinalizado.

void reset();

set

Sinaliza o evento.

void set();

Observações

A sinalização do evento pode fazer com que um número arbitrário de contextos aguardando o evento se torne executável.

timeout_infinite

Valor que indica que uma espera nunca deve expirar.

static const unsigned int timeout_infinite = COOPERATIVE_TIMEOUT_INFINITE;

wait

Aguarda que o evento seja sinalizado.

size_t wait(unsigned int _Timeout = COOPERATIVE_TIMEOUT_INFINITE);

Parâmetros

_Timeout
Indica o número de milissegundos antes do tempo limite de espera. O valor COOPERATIVE_TIMEOUT_INFINITE significa que não há tempo limite.

Valor de retorno

Se a espera foi satisfeita, o valor 0 é retornado, caso contrário, o valor COOPERATIVE_WAIT_TIMEOUT para indicar que a espera expirou sem que o evento se tornasse sinalizado.

Importante

Em um aplicativo da Plataforma Universal do Windows (UWP), não chame wait o thread ASTA porque essa chamada pode bloquear o thread atual e fazer com que o aplicativo pare de responder.

wait_for_multiple

Aguarda que vários eventos sejam sinalizados.

static size_t __cdecl wait_for_multiple(
    _In_reads_(count) event** _PPEvents,
    size_t count,
    bool _FWaitAll,
    unsigned int _Timeout = COOPERATIVE_TIMEOUT_INFINITE);

Parâmetros

_PPEvents
Uma série de eventos para esperar. O número de eventos dentro da matriz é indicado pelo count parâmetro.

contagem
A contagem de eventos dentro da matriz fornecida no _PPEvents parâmetro.

_FWaitAll
Se definido como o valor true, o parâmetro especifica que todos os eventos dentro da matriz fornecida no _PPEvents parâmetro devem ser sinalizados para satisfazer a espera. Se definido como o valor false, ele especifica que qualquer evento dentro da matriz fornecida no parâmetro que se torna sinalizado _PPEvents satisfará a espera.

_Timeout
Indica o número de milissegundos antes do tempo limite de espera. O valor COOPERATIVE_TIMEOUT_INFINITE significa que não há tempo limite.

Valor de retorno

Se a espera foi satisfeita, o índice dentro da matriz fornecido no parâmetro que satisfez a _PPEvents condição de espera, caso contrário, o valor COOPERATIVE_WAIT_TIMEOUT para indicar que a espera expirou sem que a condição fosse satisfeita.

Observações

Se o parâmetro _FWaitAll é definido como o valor true para indicar que todos os eventos devem ser sinalizados para satisfazer a espera, o índice retornado pela função não tem nenhum significado especial além do fato de que não é o valor COOPERATIVE_WAIT_TIMEOUT.

Importante

Em um aplicativo da Plataforma Universal do Windows (UWP), não chame wait_for_multiple o thread ASTA porque essa chamada pode bloquear o thread atual e fazer com que o aplicativo pare de responder.

Consulte também

namespace de simultaneidade