SetCoalescableTimer

指定されたタイムアウト値と結合許容遅延を持つタイマを作成する。

SetCoalescableTimer hWnd, nIDEvent, uElapse, lpTimerFunc, uToleranceDelay

hWnd : [intptr] 型: HWND タイマに関連付けるウィンドウへのハンドル。このウィンドウは呼び出しスレッドが所有している必要がある。
nIDEvent : [int] 型: UINT_PTR タイマ識別子。hWnd が NULL で nIDEvent が既存のタイマと一致しない場合、nIDEvent は無視され新しいタイマ ID が生成される。
uElapse : [int] 型: UINT タイムアウト値(ミリ秒単位)。USER_TIMER_MINIMUM (0x0000000A) より小さい場合は USER_TIMER_MINIMUM に設定される。USER_TIMER_MAXIMUM (0x7FFFFFFF) より大きい場合は USER_TIMER_MAXIMUM に設定される。
lpTimerFunc : [int] 型: TIMERPROC タイムアウト値が経過したときに通知される関数へのポインタ。NULL の場合、システムは WM_TIMER メッセージをアプリケーションキューにポストする。
uToleranceDelay : [int] 型: ULONG

(プラグイン / モジュール : user32.dll)

解説

指定されたタイムアウト値と結合許容遅延を持つタイマを作成する。

[戻り値]
型: UINT_PTR 関数が成功し hWnd が NULL の場合、戻り値は新しいタイマを識別する整数。hWnd が NULL
でない場合は 0 以外の整数。失敗した場合は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
アプリケーションはウィンドウプロシージャに WM_TIMER case 文を含めるか、タイマ作成時に TimerProc
コールバック関数を指定して WM_TIMER メッセージを処理できる。uToleranceDelay が 0
の場合、システム既定のタイマ結合が使用され、SetCoalescableTimer は SetTimer
と同じ動作をする。SetCoalescableTimer
や他のタイマ関連関数を使用する前に、SetUserObjectInformationW で
UOI_TIMERPROC_EXCEPTION_SUPPRESSION フラグを FALSE に設定することが推奨される。

情報