event::wait_for_multiple (Método)

Artículo
06/09/2015

Espera a que se señalen varios eventos.

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
Matriz de eventos en la que se va a esperar. El número de eventos dentro de la matriz viene indicado por el parámetro _Count.
_Count
El número de eventos dentro de la matriz proporcionado por el parámetro _PPEvents.
_FWaitAll
Si está establecido en el valor true, el parámetro especifica que todos los eventos de la matriz proporcionada en el parámetro _PPEvents deben señalarse para satisfacer la espera. Si está establecido en el valor false, especifica que cualquier evento de la matriz proporcionada en el parámetro _PPEvents que se ha señalado satisfará la espera.
_Timeout
Indica el número de milisegundos antes de que se agote el tiempo de espera. El valor COOPERATIVE_TIMEOUT_INFINITE significa que no hay tiempo de espera.

Valor devuelto

Si se satisfizo la espera, el índice de la matriz proporcionada en el parámetro _PPEvents que satisfizo la condición de espera; de lo contrario, el valor COOPERATIVE_WAIT_TIMEOUT para indicar que el tiempo de la espera se agota sin satisfacer la condición.

Comentarios

Si el parámetro _FWaitAll está establecido en el valor true para indicar que todos los eventos se deben señalar para satisfacer la espera, el índice que devuelve la función no tiene ninguna importancia especial aparte del hecho de que no es el valor COOPERATIVE_WAIT_TIMEOUT.

Importante

En una aplicación de la Tienda Windows, no llame a wait_for_multiple en el subproceso ASTA puesto que esta llamada puede bloquear el subproceso actual y puede producir que la aplicación deje de responder.