capSetCallbackOnYield マクロ (vfw.h)
capSetCallbackOnYield マクロは、アプリケーションでコールバック関数を設定します。 AVICap は、ストリーミング キャプチャ中にキャプチャ ウィンドウが生成されるときに、このプロシージャを呼び出します。 このマクロを使用するか、 WM_CAP_SET_CALLBACK_YIELD メッセージを明示的に呼び出すことができます。
構文
void capSetCallbackOnYield(
hwnd,
fpProc
);
パラメーター
hwnd
キャプチャ ウィンドウへのハンドル。
fpProc
capYieldCallback 型の yield コールバック関数へのポインター。 以前にインストールされた yield コールバック関数を無効にするには、このパラメーターに NULL を 指定します。
戻り値
なし
解説
アプリケーションでは、必要に応じて yield コールバック関数を設定できます。 yield コールバック関数は、ストリーミング キャプチャ中にキャプチャされたビデオ フレームごとに少なくとも 1 回呼び出されます。 yield コールバック関数がインストールされている場合、CAPTUREPARMS 構造体の fYield メンバーの状態に関係なく呼び出されます。
yield コールバック関数を使用する場合は、キャプチャ セッションを開始する前にインストールする必要があり、セッションの間は有効なままにする必要があります。 ストリーミング キャプチャの終了後に無効にすることができます。
アプリケーションは通常、WinMain 関数のメッセージ ループのように、PeekMessage、TranslateMessage、DispatchMessage ループで構成されるコールバック関数で何らかの種類のメッセージ処理を実行します。 yield コールバック関数では、再入の問題を引き起こす可能性のあるメッセージをフィルター処理して削除する必要もあります。
アプリケーションは通常、ストリーミング キャプチャを続行するために yield プロシージャで TRUE を 返します。 yield コールバック関数が FALSE を返した場合、キャプチャ ウィンドウはキャプチャ プロセスを停止します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vfw.h |