event::wait_for_multiple – metoda

Článek
06/09/2015

Čeká na signálování více událostí.

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

Parametry

_PPEvents
Pole událostí pro čekání.Počet událostí v poli je vyjádřen parametrem _Count.
_Count
Počet událostí v poli v parametru _PPEvents.
_FWaitAll
Pokud je nastavena hodnota true, parametr určuje, že všechny události v poli dodané v parametru _PPEvents se musí stát signalizovanými, aby vyhověly čekání.Pokud je nastavena hodnotu false, určuje, že všechny události v poli dodané v parametru _PPEvents se stávají signalizovanými a vyhoví čekání.
_Timeout
Označuje počet milisekund před vypršením čekání.Hodnota COOPERATIVE_TIMEOUT_INFINITE znamená, že neexistuje žádný časový limit.

Vrácená hodnota

Pokud bylo čekání uspokojeno, index v poli dodaném v parametru _PPEvents, který splnil čekací podmínku; jinak hodnota COOPERATIVE_WAIT_TIMEOUT k označení vypršení čekání bez splnění podmínky.

Poznámky

Pokud je parametr _FWaitAll nastaven na hodnotu true, aby označoval, že všechny události musí být signalizovány, aby splnily čekání, index vrácený funkcí nemá žádný speciální význam mimo skutečnost, že nejde o hodnotu COOPERATIVE_WAIT_TIMEOUT.

Důležité
V aplikaci Windows Store nevolejte wait_for_multiple na ASTA vlákno, protože toto volání může blokovat aktuální vlákno a může způsobit, že aplikace přestane reagovat.