event::wait_for_multiple-Methode
Wartet, bis mehrere Ereignisse signalisiert werden.
static size_t __cdecl wait_for_multiple(
_In_reads_(_Count) event ** _PPEvents,
size_t _Count,
bool _FWaitAll,
unsigned int _Timeout = COOPERATIVE_TIMEOUT_INFINITE
);
Parameter
_PPEvents
Ein Array von Ereignissen, auf die gewartet werden soll. Die Anzahl der Ereignisse im Array wird durch den _Count-Parameter angegeben._Count
Die Anzahl von Ereignissen innerhalb des im _PPEvents-Parameter angegebenen Arrays._FWaitAll
Wenn der Parameter auf den Wert true festgelegt wird, gibt dies an, dass innerhalb des Arrays, das im _PPEvents-Parameter angegeben wurde, alle Ereignisse ausgelöst werden müssen, um den Wartevorgang zu beenden. Eine Festlegung auf den Wert false gibt an, dass jedes ausgelöste Ereignis innerhalb des Arrays, das im _PPEvents-Parameter angegeben wurde, für den Wartevorgang ausreichend ist._Timeout
Gibt die Wartezeit in Millisekunden bis zum Timeout an. Der Wert COOPERATIVE_TIMEOUT_INFINITE gibt an, dass kein Timeout besteht.
Rückgabewert
Wenn die Anforderungen des Wartevorgangs erfüllt wurden, ist dies der Index innerhalb des Arrays, das im _PPEvents-Parameter angegeben wurde und die Wartebedingung erfüllt hat. Andernfalls gibt der Wert COOPERATIVE_WAIT_TIMEOUT an, dass das Timeout für den Wartevorgang abgelaufen ist, ohne dass die Bedingung erfüllt wurde.
Hinweise
Wenn der Parameter _FWaitAll auf den Wert true festgelegt wurde, um anzugeben, dass alle Ereignisse signalisiert werden müssen, um den Wartevorgang zu beenden, hat der von der Funktion zurückgegebene Index keine andere besondere Bedeutung außer der Tatsache, dass er nicht den Wert COOPERATIVE_WAIT_TIMEOUT darstellt.
Wichtig
Rufen Sie wait_for_multiple in einer Windows Store-App nicht auf dem ASTA-Thread auf, da dieser Aufruf den aktuellen Thread blockieren kann und die App dadurch möglicherweise nicht mehr reagiert.
Anforderungen
Header: concrt.h
Namespace: Parallelität