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，而不是在進程初始化期間從靜態建構函式呼叫。

請勿從工作佇列線程呼叫 MFStartup 或 MFShutdown 。如需工作佇列的詳細資訊，請參閱工作佇列。

如果已安裝 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