ホーム › Media.Multimedia › CAPCONTROLCALLBACK

CAPCONTROLCALLBACK

コールバック

シグネチャ

LRESULT CAPCONTROLCALLBACK(
    HWND hWnd,
    INT nState
);

パラメーター

フィールド	型	説明
hWnd	HWND	コールバック関数に関連付けられたキャプチャウィンドウのハンドル。
nState	INT	キャプチャ操作の現在の状態。CONTROLCALLBACK_PREROLL 値は最初に送信され、ビデオソースのプリロールを可能にするとともに、記録を開始する正確なタイミングでキャプチャアプリケーションに制御を返します。CONTROLCALLBACK_CAPTURING 値はキャプチャされたフレームごとに 1 回送信され、ストリーミングキャプチャが進行中であることを示すとともに、アプリケーションがキャプチャを終了できるようにします。

公式ドキュメント

capControlCallback 関数は、ストリーミングキャプチャの開始と終了を精密に制御するために使用されるコールバック関数です。capControlCallback という名前は、アプリケーションが指定する関数名のプレースホルダーです。

このコールバックを設定するには、キャプチャウィンドウに WM_CAP_SET_CALLBACK_CAPCONTROL メッセージを送信するか、capSetCallbackOnCapControl マクロを呼び出します。

戻り値

nState が CONTROLCALLBACK_PREROLL に設定されている場合、このコールバック関数は、キャプチャを開始するには TRUE を、中止するには FALSE を返す必要があります。nState が CONTROLCALLBACK_CAPTURING に設定されている場合、このコールバック関数は、キャプチャを継続するには TRUE を、終了するには FALSE を返す必要があります。

解説(Remarks)

コールバックプロシージャに最初に送信されるメッセージでは、すべてのバッファーの割り当てとその他のキャプチャ準備がすべて完了した後に、nState パラメーターが CONTROLCALLBACK_PREROLL に設定されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)