Función AvRtWaitOnThreadOrderingGroup (avrt.h)

Permite que los subprocesos de cliente de un grupo de ordenación de subprocesos esperen hasta que se ejecuten.

Sintaxis

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

Parámetros

[in] Context

Identificador de contexto. El identificador lo devuelve la función AvRtCreateThreadOrderingGroup o AvRtJoinThreadOrderingGroup .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cuando se devuelve esta función, el subproceso debe completar su procesamiento durante el período y, a continuación, volver a llamar a la función.

Si el subproceso no puede completar su procesamiento durante el intervalo de tiempo de espera especificado por el subproceso primario al crear el grupo, se elimina del grupo de ordenación de subprocesos. Por lo tanto, cuando el subproceso finaliza su bucle de procesamiento, se produce un error en la siguiente llamada a AvRtWaitOnThreadOrderingGroup y se establece el último código de error en ERROR_ACCESS_DENIED.

Si el grupo de ordenación de subprocesos se elimina durante la espera, esta función agota el tiempo de espera y devuelve ERROR_ACCESS_DENIED.

Ejemplos

#include <windows.h>
#include <avrt.h>
#include <stdio.h>

#pragma comment(lib, "Avrt.lib")

HANDLE Context;

int main( void )
{
    while(AvRtWaitOnThreadOrderingGroup(Context))
    {
        // Complete task for this period.
    }

return 0;
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	avrt.h
Library	Avrt.lib
Archivo DLL	Avrt.dll

Consulte también

Servicio de ordenación de subprocesos