Share via


AvRtWaitOnThreadOrderingGroup 함수(avrt.h)

스레드 순서 그룹의 클라이언트 스레드가 실행될 때까지 기다릴 수 있도록 합니다.

구문

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

매개 변수

[in] Context

컨텍스트 핸들입니다. 이 핸들은 AvRtCreateThreadOrderingGroup 또는 AvRtJoinThreadOrderingGroup 함수에 의해 반환됩니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 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
헤더 avrt.h
라이브러리 Avrt.lib
DLL Avrt.dll

추가 정보

스레드 순서 지정 서비스