Share via

MFPCreateMediaPlayer 函式 (mfplay.h)

  • 發行項
重要 廢棄。 此 API 可能會從未來的 Windows 版本中移除。 應用程式應該使用 媒體會話 播放。
 

建立 MFPlay player 物件的新實例。

語法

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

參數

[in] pwszURL

以 Null 結束的字串，其中包含要開啟之媒體檔案的 URL。 此參數可以是 Null。 如果參數為 NULL，fStartPlayback 必須是 FALSE。

如果此參數為 NULL，您可以稍後呼叫 IMFPMediaPlayer：：CreateMediaItemFromURL 來開啟 URL。

[in] fStartPlayback

如果 為TRUE，則會自動啟動播放。 如果 為 FALSE，則在應用程式呼叫 IMFMediaPlayer：:P lay 之前，才會開始播放。

如果 pwszURL 為 NULL，則會忽略此參數。

[in] creationOptions

從 _MFP_CREATION_OPTIONS 列舉中，位 OR 為多個旗標的零。

[in] pCallback

應用程式所實作之回呼物件的 IMFPMediaPlayerCallback 介面指標。 使用此介面可從 MFPlay 播放程式物件取得事件通知。 此參數可以是 Null。 如果參數為 NULL，應用程式將不會從播放機物件接收事件通知。

[in] hWnd

顯示視訊之視窗的句柄。 若為僅限音訊播放，此參數可以是 NULL。

hWnd 指定的視窗會用於來源中第一個選取的視訊數據流。 如果來源有多個視訊串流，您必須呼叫 IMFPMediaItem：：SetStreamSink ，在第一個影片串流之後轉譯任何視訊串流。

如果 hWnd 為 NULL，除非應用程式呼叫 IMFPMediaItem：：SetStreamSink 來指定視訊串流的媒體接收，否則 MFPlay 將不會顯示任何視訊。

[out] ppMediaPlayer

接收 IMFPMediaPlayer 介面的指標。 呼叫端必須釋放 介面。 此參數可以是 Null。 如果此參數為 NULL，fStartPlayback 必須是 TRUE，pwszURL 不能是 NULL。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

呼叫此函式之前，請從相同的線程呼叫 CoIntialize (Ex) ，以初始化 COM 連結庫。

在內部， MFPCreateMediaPlayer 會呼叫 MFStartup 來初始化 Microsoft Media Foundation 平臺。 當玩家對象終結時，它會呼叫 MFShutdown 來關閉平臺。 使用 MFPlay 時，應用程式不需要呼叫 MFStartup 或 MFShutdown 。

注意 如果您在播放程式物件的生命週期之外使用其他媒體基礎 API，則您的應用程式應該呼叫 MFStartup 和 MFShutdown。
 

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 mfplay.h
程式庫 Mfplay.lib
Dll Mfplay.dll

另請參閱

媒體基礎函式

使用 MFPlay 進行音訊/視訊播放