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	Media Foundation はシステムに実装されていません。このエラーは、メディアコンポーネントが存在しない場合に発生する可能性があります (詳細については、「KB2703761 」を参照してください)。

Media Foundation を使用する前に、アプリケーションでこの関数を呼び出す必要があります。アプリケーションが終了する前に、MFStartup への以前の呼び出しごとに MFShutdown を 1 回呼び出します。

MFStartup は、プロセスの初期化中に静的コンストラクターからではなく、アプリの初期化中に呼び出す必要があります。

作業キュー・スレッドから MFStartup または MFShutdown を呼び出さないでください。作業キューの詳細については、「作業キュー」を参照してください。

この機能は、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

Windows XP 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 の更新プログラムのロールアップ) がインストールされています。

    hr = MFStartup(MF_VERSION);

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