Share via

WM_CAP_SET_CALLBACK_CAPCONTROL メッセージ

  • [アーティクル]

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

WM_CAP_SET_CALLBACK_CAPCONTROL 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (fpProc);

パラメーター

fpProc

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

戻り値

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

解説

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

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Vfw.h

関連項目

ビデオ キャプチャ

ビデオ キャプチャ メッセージ