Compartilhar via


Método event::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 matriz de eventos a espera. O número de eventos dentro da matriz é indicado pelo parâmetro _Count.

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

  • _FWaitAll
    Se definida para o valor true, o parâmetro especifica que todos os eventos dentro da matriz especificada no parâmetro _PPEvents devem ser assinados para satisfazer a espera. Se definida para o valor false, ela especifica que qualquer evento dentro da matriz fornecida no parâmetro de _PPEvents que for assinado satisfará a espera.

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

Valor de retorno

Se a espera foi satisfazida, o índice dentro da matriz fornecida no parâmetro de _PPEvents que satisfez a condição de espera; caso contrário, o valor COOPERATIVE_WAIT_TIMEOUT indica que o tempo limite da espera expirou sem satisfazer a condição.

Comentários

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

Importante

Em um aplicativo de Windows Store , não chame wait_for_multiple no thread de ASTA, pois essa chamada pode bloquear o thread atual e fazer com que o aplicativo pare de responder.

Requisitos

Cabeçalho: concrt.h

Namespace: simultaneidade

Consulte também

Referência

Classe event

Método event::wait

COOPERATIVE_TIMEOUT_INFINITE

COOPERATIVE_WAIT_TIMEOUT