Compartir a través de

Función AvRtWaitOnThreadOrderingGroup (avrt.h)

  • Artículo

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