description | ms.assetid | title | ms.topic | ms.date |
---|---|---|---|---|
Specifies whether to load hardware-based Microsoft Media Foundation transforms (MFTs) in the topology. |
f7ac3c9b-c163-412f-84c0-27bf551091d8 |
MF_TOPOLOGY_HARDWARE_MODE attribute (Mfidl.h) |
reference |
05/31/2018 |
Specifies whether to load hardware-based Microsoft Media Foundation transforms (MFTs) in the topology.
MFTOPOLOGY_HARDWARE_MODE stored as UINT32
To get this attribute, call IMFAttributes::GetUINT32.
To set this attribute, call IMFAttributes::SetUINT32.
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.
Requirement | Value |
---|---|
Minimum supported client |
Windows 7 [desktop apps only] |
Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
Header |
|