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

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

 

現在のメディア項目へのポインターを取得します。

構文

HRESULT GetMediaItem(
  [out] IMFPMediaItem **ppIMFPMediaItem
);

パラメーター

[out] ppIMFPMediaItem

メディア アイテムの IMFPMediaItem インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
E_FAIL	現在のメディア項目はありません。
MF_E_NOT_FOUND	現在のメディア項目はありません。
MF_E_SHUTDOWN	オブジェクトの Shutdown メソッドが呼び出されました。

解説

IMFPMediaPlayer::SetMediaItem メソッドは非同期です。 したがって、 SetMediaItem が保留中の間、 GetMediaItem は設定されたメディア項目を返しません。 代わりに、アプリケーションで IMFPMediaPlayerCallback インターフェイスを実装し、 MFP_EVENT_TYPE_MEDIAITEM_SET イベントを処理する必要があります。 詳細については、「 プレーヤーからのイベントの受信」を参照してください。

前の解説は、 MFPCreateMediaPlayer 関数でメディア項目を設定する場合にも当てはまります。

要件

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

関連項目

IMFPMediaPlayer

オーディオ/ビデオ再生に MFPlay を使用する