IMFPMediaPlayer::FrameStep メソッド (mfplay.h)

大事な 廃止。この API は、Windows の今後のリリースから削除される可能性があります。アプリケーションでは、再生にメディアセッションを使用する必要があります。

1 つのビデオフレームを進める。

構文

HRESULT FrameStep();

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDREQUEST	フレームステップを実行できません。このエラーコードの理由は次のとおりです。再生用にキューに入っているメディア項目はありません。現在のメディア項目にビデオが含まれていません。
MF_E_SHUTDOWN	オブジェクトの Shutdown メソッドが呼び出されました。
MF_E_UNSUPPORTED_RATE	メディアソースではフレームステップ実行がサポートされていないか、現在の再生レートが負の値です。

このメソッドは非同期的に完了します。操作が完了すると、アプリケーションの IMFPMediaPlayerCallback::OnMediaPlayerEvent コールバックメソッドが呼び出されます。イベントの種類が MFP_EVENT_TYPE_FRAME_STEP。

プレーヤーオブジェクトは、反転再生中のフレームステップ実行をサポートしていません (つまり、再生レートが負の場合)。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfplay.h