Функция AvRtWaitOnThreadOrderingGroup (avrt.h)

Позволяет клиентским потокам группы упорядочения потоков ожидать выполнения.

Синтаксис

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

Параметры

[in] Context

Дескриптор контекста. Этот дескриптор возвращается функцией AvRtCreateThreadOrderingGroup или AvRtJoinThreadOrderingGroup .

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Когда эта функция возвращается, поток должен завершить обработку в течение периода, а затем снова вызвать функцию.

Если потоку не удается завершить обработку в течение интервала времени ожидания, заданного родительским потоком при создании группы, он удаляется из группы упорядочения потоков. Поэтому, когда поток завершает свой цикл обработки, следующий вызов AvRtWaitOnThreadOrderingGroup завершается сбоем, и для последнего кода ошибки устанавливается значение ERROR_ACCESS_DENIED.

Если группа упорядочения потоков удаляется во время ожидания, эта функция в конечном итоге истечет время ожидания и возвращает ERROR_ACCESS_DENIED.

Примеры

#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;
}

Требования

См. также раздел

Служба упорядочения потоков