次の方法で共有

WM_CAP_SET_CALLBACK_YIELD メッセージ

  • [アーティクル]

WM_CAP_SET_CALLBACK_YIELD メッセージは、アプリケーションでコールバック関数を設定します。 AVICap は、ストリーミング キャプチャ中にキャプチャ ウィンドウが生成されるときに、このプロシージャを呼び出します。 このメッセージは、明示的に送信することも、 capSetCallbackOnYield マクロを使用して送信することもできます。

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

パラメーター

fpProc

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

戻り値

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

解説

アプリケーションでは、必要に応じて yield コールバック関数を設定できます。 yield コールバック関数は、ストリーミング キャプチャ中にキャプチャされたビデオ フレームごとに少なくとも 1 回呼び出されます。 yield コールバック関数がインストールされている場合は、CAPTUREPARMS 構造体の fYield メンバーの状態に関係なく呼び出されます。

yield コールバック関数を使用する場合は、キャプチャ セッションを開始する前にインストールする必要があり、セッションの期間中は有効なままにする必要があります。 ストリーミング キャプチャの終了後に無効にすることができます。

アプリケーションは通常、WinMain 関数のメッセージ ループのように、PeekMessage、TranslateMessage、DispatchMessage ループで構成されるコールバック関数で何らかの種類のメッセージ処理を実行します。 yield コールバック関数では、再入の問題を引き起こす可能性のあるメッセージをフィルター処理して削除する必要もあります。

通常、アプリケーションはストリーミング キャプチャを続行するために yield プロシージャで TRUE を 返します。 yield コールバック関数が FALSE を返す場合、キャプチャ ウィンドウはキャプチャ プロセスを停止します。

要件

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

関連項目

ビデオ キャプチャ

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