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	Media Foundation 平台已禁用，因为系统是在“安全模式”中启动的， (故障安全启动) 。
E_NOTIMPL	媒体基础未在系统上实现。如果媒体组件不存在，则会发生此错误 (请参阅 KB2703761 了解) 的详细信息。

应用程序在使用 Media Foundation 之前必须调用此函数。在应用程序退出之前，每次调用 MFStartup 时，都要调用 MFShutdown 一次。

应在应用初始化期间调用 MFStartup，而不是在进程初始化期间从静态构造函数调用。

不要从工作队列线程调用 MFStartup 或 MFShutdown 。有关工作队列的详细信息，请参阅工作队列。

如果安装了 Windows Media Format 11 SDK 可再发行组件，则此函数在以下平台上可用：

具有 Service Pack 2 的 Windows XP (SP2) 及更高版本。
Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和安装KB925766 (2006 年 10 月更新汇总的 Windows XP Media Center Edition) 。

    hr = MFStartup(MF_VERSION);