IMFRealTimeClient::SetWorkQueue method (mfidl.h)

Specifies the work queue for the topology branch that contains this object.

Syntax

HRESULT SetWorkQueue(
  [in] DWORD dwWorkQueueId
);

Parameters

[in] dwWorkQueueId

The identifier of the work queue, or the value MFASYNC_CALLBACK_QUEUE_UNDEFINED. See Remarks.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

An application can register a branch of the topology to use a private work queue. The Media Session notifies any pipeline object that supports IMFRealTimeClient by calling SetWorkQueue with the application's work queue identifier.

When the application unregisters the topology branch, the Media Session calls SetWorkQueue again with the value MFASYNC_CALLBACK_QUEUE_UNDEFINED.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFRealTimeClient

IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS