event::wait_for_multiple-Methode

Artikel
08/10/2011

Wartet, bis mehrere Ereignisse signalisiert werden.

_CRTIMP static size_t __cdecl wait_for_multiple(
   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 der Wartevorgang zufrieden gestellt wurde, ist dies der Index innerhalb des Arrays, das im _PPEvents-Parameter angegeben wurde und die Wartebedingung zufrieden gestellt 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.