MF_TOPONODE_WORKQUEUE_ID attribute

Specifies a work queue for a topology branch.

Data type

UINT32

Remarks

This attribute applies to source nodes (MF_TOPOLOGY_SOURCESTREAM_NODE). The attribute is optional.

The value of the attribute is an application-defined identifier for the work queue.

Applications can use this attribute to assign work queues to branches of the topology. Each source node in the topology defines one branch. The branch includes every topology node that receives data from that node.

If you set this attribute, call the IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS method on the resolved topology. Multiple branches in the topology can share the same work queue, and work queues can be re-used across topologies.

Note

The value of this attribute is not the same as the identifier that is returned by the MFAllocateWorkQueue function. The value of the attribute is an application-defined identifier, and is used to associate topology branches with work queues. When the Media Session allocates a new work queue, it stores the actual work-queue identifier internally.

 

If this attribute it set, the application can also assign the branch to a Multimedia Class Scheduler Service (MMCSS) task, by setting the MF_TOPONODE_WORKQUEUE_MMCSS_CLASS attribute.

The GUID constant for this attribute is exported from mfuuid.lib.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Mfidl.h

See also

Alphabetical List of Media Foundation Attributes

IMFAttributes::GetUINT32

IMFAttributes::SetUINT32

IMFTopologyNode

IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS

MF_TOPONODE_WORKQUEUE_MMCSS_CLASS

MF_TOPONODE_WORKQUEUE_MMCSS_TASKID

Topology Node Attributes

Work Queues