MF_TOPOLOGY_HARDWARE_MODE属性

ハードウェア ベースの Microsoft Media Foundation 変換 (MFT) をトポロジに読み込むかどうかを指定します。

データ型

UINT32 として格納されているMFTOPOLOGY_HARDWARE_MODE

取得/設定

この属性を取得するには、 IMFAttributes::GetUINT32 を呼び出します。

この属性を設定するには、 IMFAttributes::SetUINT32 を呼び出します。

適用対象

IMFTopology

解説

この属性は省略可能です。 トポロジを解決する前に 属性を設定します。

値	説明
MFTOPOLOGY_HWMODE_USE_HARDWARE	使用可能な場合、トポロジ ローダーはハードウェア ベースの MFT (ハードウェア デコーダーなど) を読み込みます。 ハードウェア デコーダーが見つからない場合、または何らかの理由でハードウェア デコーダーの接続に失敗した場合、トポロジ ローダーは自動的にソフトウェア デコードにフォールバックします。
MFTOPOLOGY_HWMODE_SOFTWARE_ONLY	トポロジ ローダーは、ソフトウェア デコーダーを含むソフトウェア MFT のみを読み込みます。

 

既存のアプリケーションとの互換性を確保するために、既定値は MFTOPOLOGY_HWMODE_SOFTWARE_ONLY です。 推奨される値は MFTOPOLOGY_HWMODE_USE_HARDWAREです。

トポロジ ローダーは、ハードウェア MFT をトポロジに挿入する場合、トポロジ ノードに MFT_ENUM_HARDWARE_URL_Attribute 属性を設定します。 ハードウェア MFT が存在するかどうかをチェックするには、解決されたトポロジ内のノードを列挙し、この属性が存在するかどうかをチェックします。

この属性の GUID 定数は、mfuuid.lib からエクスポートされます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
Header	Mfidl.h

関連項目

Media Foundation 属性のアルファベット順リスト

トポロジ属性