IVideoFrameStep::Step メソッド (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドを Step 使用すると、指定したフレーム数だけフィルター グラフがステップ フォワードされます。

構文

HRESULT Step(
  DWORD    dwFrames,
  IUnknown *pStepObject
);

パラメーター

dwFrames

スキップするフレーム数を指定します。 dwFrames が 1 の場合、グラフは 1 つのフレームを進めます。 dwFrames が 1 より大きい数値 n の場合、グラフは n から 1 フレームをスキップし、n番目のフレームを示します。

pStepObject

ステップ実行操作を制御するフィルター上のインターフェイスへのポインター( NULL)。 グラフのレンダラー フィルターを使用してフレームのステップ実行を実行するには、 NULL を 指定します。 NULL 以外の場合、オブジェクトは IKsPropertySet インターフェイスを実装し、AM_KSPROPSETID_FrameStep プロパティをサポートする必要があります。 (詳細については、「 フレーム ステップ実行プロパティ セット」を参照してください)。フレーム ステップ実行を実装するカスタム フィルターがグラフに含まれている場合、 pStepObject はそのフィルターへのポインターを指定できます。

戻り値

HRESULT を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_OK
 正常終了しました。
VFW_E_FRAME_STEP_UNSUPPORTED
 フレームのステップ実行はサポートされていません。
E_INVALIDARG
 pStepObject パラメーターが無効です。

注釈

ステップ操作が完了すると、このメソッドはフィルター グラフ マネージャーに EC_STEP_COMPLETE イベント通知を送信します。これにより、アプリケーションのイベント ループに渡され、フィルター グラフが一時停止状態に設定されます。

フレーム ステップをリアルタイムで実行します。つまり、ムービーが 30 フレーム/秒で再生されている場合、dwFrames を 60 に設定して IVideoFrameStep::Step を呼び出すと、実行に 2 秒かかります。 このインターフェイス内のすべてのメソッドは非同期であるため、コントロールはすぐにアプリケーションに戻ります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

エラーコードと成功コード

IVideoFrameStep インターフェイス