event::wait_for_multiple — Metoda

Artykuł
06/09/2015

Czeka na wiele zdarzeń, aby zostały zasygnalizowane.

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
Tablica zdarzeń oczekiwania.Liczba zdarzeń w tablicy jest wskazywana przez _Count parametr.
_Count
Liczba zdarzeń w tablicy dostarczana w _PPEvents parametrze.
_FWaitAll
Jeśli ustawiona na wartość true, parametr określa, że wszystkie zdarzenia w tablicy dostarczanej w parametrze _PPEvents muszą zostać sygnalizowane, aby spełniać oczekiwanie.Jeśli ustawiona na wartość false, określa, że dowolne zdarzenie w tablicy dostarczanej w parametrze _PPEvents, który jest sygnalizowany, będzie spełniać oczekiwania.
_Timeout
Wskazuje liczbę milisekund do upłynięcia czasu oczekiwania.Wartość COOPERATIVE_TIMEOUT_INFINITE oznacza, że nie ma limitu czasu.

Wartość zwracana

Jeśli czas oczekiwania był zadawalający, indeks w tablicy dostarczany w parametrze _PPEvents spełniającym warunek oczekiwania; w przeciwnym wypadku wartość COOPERATIVE_WAIT_TIMEOUT, aby wskazać, że upłynął limit czasu oczekiwania bez spełnienia warunku.

Uwagi

Jeśli parametr _FWaitAll ustawiono na wartość true, aby wskazać, że wszystkie zdarzenia muszą być sygnalizowane, aby zaspokoić oczekiwania, wskaźnik zwracany przez funkcję nie niesie ze sobą specjalnego znaczenie poza tym, że nie jest wartością COOPERATIVE_WAIT_TIMEOUT.

Ważne
W aplikacji Windows Store nie wywołuj wait_for_multiple na wątku ASTA, ponieważ to wywołanie może zablokować bieżący wątek i może spowodować, że aplikacja przestanie odpowiadać.