CWinThread::OnIdle

[アーティクル]
08/09/2011

アイドル処理を行う場合は、このメンバー関数をオーバーライドします。

virtual BOOL OnIdle(
   LONG lCount 
);

パラメーター

lCount
スレッドのメッセージキューが空のときに OnIdle 関数が呼び出されると、そのたびに増加されるカウンター。このカウンターは、新しいメッセージが処理されるたびに 0 にリセットされます。パラメーター lCount を使うと、スレッドがメッセージを処理せずにアイドル状態になっている時間の相対的な長さを調べることができます。

戻り値

さらにアイドル処理時間が必要な場合は 0 以外を返します。アイドル処理時間が必要ない場合は 0 を返します。

解説

スレッドのメッセージキューが空だと、既定のメッセージループで OnIdle 関数が呼び出されます。独自のバックグラウンドアイドル処理を呼び出すには、自身でオーバーライドした関数を使用します。

OnIdle 関数は、これ以上のアイドル処理時間を必要としないことを示すために 0 を返します。パラメーター lCount は、メッセージキューが空のときに OnIdle 関数が呼び出されるたびに増分され、新しいメッセージが処理されるたびに 0 にリセットされます。このカウントに基づいて、別のアイドル処理ルーチンを呼び出すことができます。

このメンバー関数の既定の実装では、一時オブジェクトや未使用のダイナミックリンクライブラリがメモリから解放されます。

このメンバー関数は、ユーザーインターフェイススレッドでだけ使用されます。

OnIdle 関数から戻るまでアプリケーションはメッセージを処理できないので、この関数で長い処理を行わないようにしてください。