ホーム › Media.Multimedia › CAPSTATUSCALLBACKW

CAPSTATUSCALLBACKW

コールバック

シグネチャ

LRESULT CAPSTATUSCALLBACKW(
    HWND hWnd,
    INT nID,
    LPWSTR lpsz
);

パラメーター

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

公式ドキュメント

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)