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 インターフェイスをサポートするオブジェクトを返す必要があります。
保護されたメディア パス (PMP) プロセスで MFT を登録する必要がある場合は、 IMFLocalMFTRegistration インターフェイスを使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfapi.h |
| Library | Mfplat.lib |
| [DLL] | Mfplat.dll |