Функция 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;
}

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header avrt.h
Библиотека Avrt.lib
DLL Avrt.dll

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

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