capSetCallbackOnCapControl マクロ (vfw.h)

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

構文

BOOL capSetCallbackOnCapControl(
     hwnd,
     fpProc
);

パラメーター

hwnd

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

fpProc

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

戻り値

型: BOOL

成功した場合は TRUE、 ストリーミングキャプチャまたは単一フレームキャプチャセッションが進行中の場合は FALSE を返します。

注釈

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

要求事項

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	vfw.h