MFTRegisterLocalByCLSID 関数 (mfapi.h)

呼び出し元のプロセスに Media Foundation 変換 (MFT) を登録します。

構文

HRESULT MFTRegisterLocalByCLSID(
  [in] REFCLSID                     clisdMFT,
  [in] REFGUID                      guidCategory,
  [in] LPCWSTR                      pszName,
  [in] UINT32                       Flags,
  [in] UINT32                       cInputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pInputTypes,
  [in] UINT32                       cOutputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pOutputTypes
);

パラメーター

[in] clisdMFT

MFT のクラス識別子 (CLSID)。

[in] guidCategory

MFT のカテゴリを指定する GUID。 MFT カテゴリの一覧については、「 MFT_CATEGORY」を参照してください。

[in] pszName

MFT のフレンドリ名を含むワイド文字の null で終わる文字列。

[in] Flags

_MFT_ENUM_FLAG列挙からの 0 個以上のフラグのビットごとの OR。

[in] cInputTypes

pInputTypes 配列内の要素の数。

[in] pInputTypes

MFT_REGISTER_TYPE_INFO構造体の配列へのポインター。 配列の各メンバーは、MFT でサポートされる入力形式を指定します。 cInputTypes が 0 の場合、このパラメーターは NULL にすることができます。

[in] cOutputTypes

pOutputTypes 配列内の要素の数。

[in] pOutputTypes

MFT_REGISTER_TYPE_INFO構造体の配列へのポインター。 配列の各メンバーは、MFT でサポートされる出力形式を定義します。 cOutputTypes が 0 の場合、このパラメーターは NULL にすることができます。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この機能の主な目的は、MFT を他のプロセスやアプリケーションで使用できるようにせずに、MFT を自動トポロジ解決に使用できるようにするためです。

この関数を呼び出した後、 MFTEnumEx 関数を MFT_ENUM_FLAG_LOCALMFT フラグで呼び出すことで、MFT を列挙できます。 MFT は同じプロセス内から列挙できますが、他のプロセスには表示されません。

現在のプロセスから MFT の登録を解除するには、 MFTUnregisterLocalByCLSID を呼び出します。

保護されたメディア パス (PMP) プロセスで MFT を登録する必要がある場合は、 IMFLocalMFTRegistration インターフェイスを使用します。

要件

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

こちらもご覧ください

MFTRegisterLocal

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