Função AvRtWaitOnThreadOrderingGroup (avrt.h)

Permite que os threads de cliente de um grupo de ordenação de thread aguardem até que eles sejam executados.

Sintaxe

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

Parâmetros

[in] Context

Um identificador de contexto. Esse identificador é retornado pela função AvRtCreateThreadOrderingGroup ou AvRtJoinThreadOrderingGroup .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Quando essa função retorna, o thread deve concluir seu processamento para o período e, em seguida, chamar a função novamente.

Se o thread não concluir o processamento durante o intervalo de tempo limite especificado pelo thread pai ao criar o grupo, ele será excluído do grupo de ordenação de thread. Portanto, quando o thread termina seu loop de processamento, a próxima chamada para AvRtWaitOnThreadOrderingGroup falha e o último código de erro é definido como ERROR_ACCESS_DENIED.

Se o grupo de ordenação de threads for excluído durante a espera, essa função eventualmente atingirá o tempo limite e retornará ERROR_ACCESS_DENIED.

Exemplos

#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	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	avrt.h
Biblioteca	Avrt.lib
DLL	Avrt.dll

Confira também

Serviço de Ordenação de Threads