Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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