Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
TimerAPCProc
Collapse the table of content
Expand the table of content

TimerAPCProc callback function

An application-defined timer completion routine. Specify this address when calling the SetWaitableTimer function. The PTIMERAPCROUTINE type defines a pointer to this callback function. TimerAPCProc is a placeholder for the application-defined function name.

Syntax


VOID CALLBACK TimerAPCProc(
  _In_opt_ LPVOID lpArgToCompletionRoutine,
  _In_     DWORD  dwTimerLowValue,
  _In_     DWORD  dwTimerHighValue
);

Parameters

lpArgToCompletionRoutine [in, optional]

The value passed to the function using the lpArgToCompletionRoutine parameter of the SetWaitableTimer function.

dwTimerLowValue [in]

The low-order portion of the UTC-based time at which the timer was signaled. This value corresponds to the dwLowDateTime member of the FILETIME structure. For more information about UTC-based time, see System Time.

dwTimerHighValue [in]

The high-order portion of the UTC-based time at which the timer was signaled. This value corresponds to the dwHighDateTime member of the FILETIME structure.

Return value

This function does not return a value.

Remarks

The completion routine is executed by the thread that activates the timer using SetWaitableTimer. However, the thread must be in an alertable state. For more information, see Asynchronous Procedure Calls.

Examples

For an example, see Using a Waitable Timer with an Asynchronous Procedure Call.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinBase.h (include Windows.h)

See also

SetWaitableTimer

 

 

Community Additions

ADD
Show:
© 2015 Microsoft