Share via

MFPCreateMediaPlayer 関数 (mfplay.h)

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

MFPlay プレーヤー オブジェクトの新しいインスタンスを作成します。

構文

HRESULT MFPCreateMediaPlayer(
  [in]  LPCWSTR                 pwszURL,
  [in]  BOOL                    fStartPlayback,
  [in]  MFP_CREATION_OPTIONS    creationOptions,
  [in]  IMFPMediaPlayerCallback *pCallback,
  [in]  HWND                    hWnd,
  [out] IMFPMediaPlayer         **ppMediaPlayer
);

パラメーター

[in] pwszURL

開くメディア ファイルの URL を含む Null で終わる文字列。 このパラメーターは、NULL でもかまいません。 パラメーターが NULL の場合、 fStartPlayback は FALSE である必要があります。

このパラメーターが NULL の場合は、 後で IMFPMediaPlayer::CreateMediaItemFromURL を呼び出して URL を開くことができます。

[in] fStartPlayback

TRUE の場合、再生が自動的に開始されます。 FALSE の場合、アプリケーションが IMFMediaPlayer::P lay を呼び出すまで再生は開始されません。

pwszURL が NULL の場合、このパラメーターは無視されます。

[in] creationOptions

_MFP_CREATION_OPTIONS列挙体の 0 個以上のフラグのビットごとの OR。

[in] pCallback

アプリケーションによって実装されるコールバック オブジェクトの IMFPMediaPlayerCallback インターフェイスへのポインター。 このインターフェイスを使用して、MFPlay プレーヤー オブジェクトからイベント通知を取得します。 このパラメーターは、NULL でもかまいません。 パラメーターが NULL の場合、アプリケーションはプレーヤー オブジェクトからイベント通知を受け取りません。

[in] hWnd

ビデオが表示されるウィンドウへのハンドル。 オーディオのみの再生の場合、このパラメーターは NULL にすることができます。

hWnd で指定されたウィンドウは、ソースで最初に選択されたビデオ ストリームに使用されます。 ソースに複数のビデオ ストリームがある場合は、 IMFPMediaItem::SetStreamSink を呼び出して、最初のストリームの後にビデオ ストリームのいずれかをレンダリングする必要があります。

hWnd が NULL の場合、MFPlay は、アプリケーションが IMFPMediaItem::SetStreamSink を呼び出してビデオ ストリームのメディア シンクを指定しない限り、ビデオを表示しません。

[out] ppMediaPlayer

IMFPMediaPlayer インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは、NULL でもかまいません。 このパラメーターが NULL の場合、 fStartPlayback は TRUE である必要があり、 pwszURL を NULL にすることはできません。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数を呼び出す前に、同じスレッドから CoIntialize(Ex) を呼び出して COM ライブラリを初期化します。

内部的には、 MFPCreateMediaPlayer はMFStartup を呼び出して Microsoft Media Foundation プラットフォームを初期化します。 プレーヤー オブジェクトが破棄されると、 MFShutdown を呼び出してプラットフォームをシャットダウンします。 アプリケーションが MFPlay を使用するときに MFStartup または MFShutdown を呼び出す必要はありません。

メモ プレーヤー オブジェクトの有効期間外に他の Media Foundation API を使用する場合は、アプリケーションで MFStartup と MFShutdown を呼び出す必要があります。
 

要件

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

こちらもご覧ください

メディア ファンデーション機能

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