ホーム › Media.Multimedia › CAPSTATUSCALLBACKA

CAPSTATUSCALLBACKA

コールバック

シグネチャ

LRESULT CAPSTATUSCALLBACKA(
    HWND hWnd,
    INT nID,
    LPSTR lpsz
);

パラメーター

フィールド	型	説明
hWnd	HWND	コールバック関数に関連付けられたキャプチャウィンドウへのハンドル。
nID	INT	メッセージ識別番号。
lpsz	LPSTR	返されたステータスのテキストによる説明へのポインター。

公式ドキュメント

capStatusCallback 関数は、ビデオキャプチャで使用されるステータスコールバック関数です。capStatusCallback という名前は、アプリケーションが提供する関数名のプレースホルダーです。

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

解説(Remarks)

キャプチャ操作中、コールバック関数に最初に送信されるメッセージは常に IDS_CAP_BEGIN であり、最後は常に IDS_CAP_END です。メッセージ識別子が 0 の場合は、新しい操作が開始されることを示しており、コールバック関数は現在のステータスをクリアする必要があります。

メモ

vfw.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして CAPSTATUSCALLBACK を定義します。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーを引き起こす可能性があります。詳細については、関数プロトタイプの規則を参照してください。

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