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