PTIMERAPCROUTINE 콜백 함수(synchapi.h)

애플리케이션 정의 타이머 완료 루틴입니다. SetWaitableTimer 함수를 호출할 때 이 주소를 지정합니다. PTIMERAPCROUTINE 형식은 이 콜백 함수에 대한 포인터를 정의합니다. TimerAPCProc 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PTIMERAPCROUTINE Ptimerapcroutine;

void Ptimerapcroutine(
  [in, optional] LPVOID lpArgToCompletionRoutine,
  [in]           DWORD dwTimerLowValue,
  [in]           DWORD dwTimerHighValue
)
{...}

매개 변수

[in, optional] lpArgToCompletionRoutine

SetWaitableTimer 함수의 lpArgToCompletionRoutine 매개 변수를 사용하여 함수에 전달된 값입니다.

[in] dwTimerLowValue

타이머가 신호를 받은 UTC 기반 시간의 하위 부분입니다. 이 값은 FILETIME 구조체의 dwLowDateTime 멤버에 해당합니다. UTC 기반 시간에 대한 자세한 내용은 시스템 시간을 참조하세요.

[in] dwTimerHighValue

타이머가 신호를 받은 UTC 기반 시간의 상위 부분입니다. 이 값은 FILETIME 구조체의 dwHighDateTime 멤버에 해당합니다.

반환 값

없음

설명

완료 루틴은 SetWaitableTimer를 사용하여 타이머를 활성화하는 스레드에서 실행됩니다. 그러나 스레드는 경고 가능한 상태여야 합니다. 자세한 내용은 비동기 프로시저 호출을 참조하세요.

예제

예를 들어 비동기 프로시저 호출과 함께 대기 가능한 타이머 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	synchapi.h(Windows.h 포함)

추가 정보

SetWaitableTimer