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 |