次の方法で共有


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

こちらもご覧ください

Media Foundation の初期化

メディア ファンデーション機能