MF_TOPOLOGY_HARDWARE_MODE attribute
Specifies whether to load hardware-based Microsoft Media Foundation transforms (MFTs) in the topology.
Data type
MFTOPOLOGY_HARDWARE_MODE stored as UINT32
Get/set
To get this attribute, call IMFAttributes::GetUINT32.
To set this attribute, call IMFAttributes::SetUINT32.
Applies to
Remarks
This attribute is optional. Set the attribute before resolving the topology.
| Value | Description |
|---|---|
| MFTOPOLOGY_HWMODE_USE_HARDWARE | The Topology Loader will load hardware-based MFTs, such as hardware decoders, when available. The Topology Loader automatically falls back to software decoding if no hardware decoder is found, or if a hardware decoder fails to connect for some reason. |
| MFTOPOLOGY_HWMODE_SOFTWARE_ONLY | The Topology Loader will load only software MFTs, including software decoders. |
The default value is MFTOPOLOGY_HWMODE_SOFTWARE_ONLY, for compatibility with existing applications. The recommended value is MFTOPOLOGY_HWMODE_USE_HARDWARE.
If the Topology Loader inserts a hardware MFT into the topology, it sets the MFT_ENUM_HARDWARE_URL_Attribute attribute on the topology node. To check whether a hardware MFT is present, enumerate the nodes in the resolved topology and check whether this attribute is present.
The GUID constant for this attribute is exported from mfuuid.lib.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 7 [desktop apps only] |
| Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
| Header |
|
See also