共用方式為


MFStartup 函式 (mfapi.h)

初始化 Microsoft Media Foundation。

語法

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

參數

Version

版本號碼。 使用 mfapi.h 中定義的 值MF_VERSION

dwFlags

使用 C++ 時,此參數是選擇性的,但在 C 中為必要參數。此值必須是下列其中一個旗標:

意義
MFSTARTUP_NOSOCKET
請勿初始化套接字連結庫。
MFSTARTUP_LITE
相當於 MFSTARTUP_NOSOCKET。
MFSTARTUP_FULL
初始化整個 Media Foundation 平臺。 未指定 dwFlags 時,這是預設值。

傳回值

函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
MF_E_BAD_STARTUP_VERSION
Version 參數需要比執行的版本更新的 Media Foundation 版本。
MF_E_DISABLED_IN_SAFEMODE
媒體基礎平臺已停用,因為系統是以「安全模式」啟動, (安全開機) 。
E_NOTIMPL
未在系統上實作媒體基礎。 如果媒體元件不存在 (請參閱 KB2703761 以取得詳細資訊) ,就會發生此錯誤。

備註

應用程式必須先呼叫此函式,才能使用 Media Foundation。 在應用程式結束之前,請針對前一次呼叫 MFStartup 呼叫 MFShutdown 一次。

應該在應用程式初始化期間呼叫 MFStartup,而不是在進程初始化期間從靜態建構函式呼叫。

請勿從工作佇列線程呼叫 MFStartupMFShutdown 。 如需工作佇列的詳細資訊,請參閱 工作佇列

如果已安裝 Windows Media Format 11 SDK 可轉散發元件,此函式可在下列平臺上使用:

  • Windows XP with Service Pack 2 (SP2) 和更新版本。
  • 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月更新匯總) 的 Windows XP Media Center Edition 2005。

範例

    hr = MFStartup(MF_VERSION);

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfapi.h
程式庫 Mfplat.lib
Dll Mfplat.dll

另請參閱

初始化媒體基礎

媒體基礎函式