Función SDL_WaitThread

Sintaxis

void SDL_WaitThread(SDL_Thread * thread, int *status);

Descripción

Espera que termine un hilo.

Parámetros

thread

El puntero SDL_Thread que fue devuelto por la llamada SDL_CreateThread() que inició este hilo.

status

Puntero a un entero que recibirá el valor devuelto por la función thread mediante su 'return', o NULL para no recibir dicho valor de vuelta.

Valor de retorno

Devuelve 0 si tiene éxito o un código de error negativo si falla. Ver SDL_GetError.

Observaciones

Los hilos que no hayan sido desacoplados permanecerán (como un "zombi") hasta que esta función los limpie. No hacerlo supone una fuga de recursos.

Una vez que un hilo ha sido limpiado a través de esta función, el SDL_Thread que hace referencia a él se convierte en inválido y no debe ser referenciado de nuevo. Como tal, solo un hilo puede llamar a SDL_WaitThread() sobre otro.

El código de retorno de la función thread se coloca en el área apuntada por status, si status no es NULL.

No se puede esperar en un hilo que ha sido utilizado en una llamada a SDL_DetachThread(). Se puede utilizar esa función o ésta, pero no ambas, o el comportamiento será indefinido.

Es seguro pasar un hilo NULL a esta función; es un no-op.

Hay que tener en cuenta que el puntero del hilo es liberado por esta función y no es válido después.