capSetCallbackOnCapControl マクロ (vfw.h)

capSetCallbackOnCapControl マクロは、正確な記録制御を提供するコールバック関数をアプリケーションに設定します。 このマクロを使用するか、 WM_CAP_SET_CALLBACK_CAPCONTROL メッセージを明示的に呼び出すことができます。

構文

void capSetCallbackOnCapControl(
   hwnd,
   fpProc
);

パラメーター

hwnd

キャプチャ ウィンドウへのハンドル。

fpProc

capControlCallback 型のコールバック関数へのポインター。 以前にインストールしたコールバック関数を無効にするには、このパラメーターに NULL を 指定します。

戻り値

なし

解説

単一のコールバック関数を使用して、ストリーミング キャプチャの開始と完了の瞬間をアプリケーションで正確に制御できます。 キャプチャ ウィンドウは、すべてのバッファーが割り当てられ、他のすべてのキャプチャ準備が完了した後、最初に nState を CONTROLCALLBACK_PREROLL に設定してプロシージャを呼び出します。 これにより、記録を開始する正確な時点でコールバック関数から返される、ビデオ ソースを事前登録する機能がアプリケーションに提供されます。 コールバック関数からの TRUE の戻り値はキャプチャを続行し、 FALSE の 戻り値はキャプチャを中止します。 キャプチャが開始されると、このコールバック関数が頻繁に呼び出され、 nState が CONTROLCALLBACK_CAPTURING に設定され、アプリケーションが FALSE を返してキャプチャを終了できるようになります。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	vfw.h

関連項目

ビデオ キャプチャ

ビデオ キャプチャ マクロ

WM_CAP_SET_CALLBACK_CAPCONTROL

capControlCallback