MFTRegisterLocal 関数 (mfapi.h)

  • [アーティクル]

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

構文

HRESULT MFTRegisterLocal(
  [in] IClassFactory                *pClassFactory,
  [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] pClassFactory

クラス ファクトリ オブジェクトの IClassFactory インターフェイスへのポインター。 クラス ファクトリによって MFT が作成されます。

[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 を自動トポロジ解決に使用できるようにするためです。

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

pClassFactory パラメーターは、MFT を作成するクラス ファクトリ オブジェクトを指定します。 クラス ファクトリの IClassFactory::CreateInstance メソッドは、 IMFTransform インターフェイスをサポートするオブジェクトを返す必要があります。

メモMFTEnumEx 関数は、IMFActivate ポインターの一覧を取得します。 ただし、クラス ファクトリは IMFActivate インターフェイスをサポートする必要はありません。 代わりに、 MFTEnumEx 関数は、クラス ファクトリをラップする IMFActivate の実装を提供します。
 
現在のプロセスから MFT の登録を解除するには、 MFTUnregisterLocal を呼び出します。

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

要件

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

こちらもご覧ください

MFTRegisterLocalByCLSID

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