Expand Minimize

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

IMFTopology

Remarks

This attribute is optional. Set the attribute before resolving the topology.

ValueDescription
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_ONLYThe 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

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mfidl.h

See also

Topology Attributes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft