IMFWorkQueueServices：：BeginRegisterTopologyWorkQueuesWithMMCSS 方法 (mfidl.h)

将拓扑工作队列注册到多媒体类计划程序服务 (MMCSS) 。

语法

HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

参数

[in] pCallback

指向回调对象的 IMFAsyncCallback 接口的指针。 调用方必须实现此接口。

[in] pState

指向调用方定义的状态对象的 IUnknown 接口的指针。 此参数可以为 NULL。 可以使用此对象来保存状态信息。 调用回调时，对象将返回到调用方。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

拓扑中的每个源节点定义拓扑的一个分支。 分支包括从该节点接收数据的每个拓扑节点。 应用程序可以为拓扑的每个分支分配其自己的工作队列，然后将这些工作队列与 MMCSS 任务相关联。

若要使用此方法，请执行以下步骤。

1. 创建拓扑。
2. 在拓扑中的源节点上设置以下属性。
   • MF_TOPONODE_WORKQUEUE_ID。 指定工作队列的标识符。 媒体会话将分配新的工作队列。
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS。 指定 MMCSS 类。
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID。 指定 MMCSS 任务标识符 (可选) 。 如果未设置此属性，MMCSS 将分配新的任务标识符。
3. 通过调用 IMFMediaSession：：SetTopology 将拓扑排队。
4. 等待具有MF_TOPOSTATUS_READY状态的 MESessionTopologyStatus 事件。
5. 调用 BeginRegisterTopologyWorkQueuesWithMMCSS。 此方法向 MMCSS 注册所有拓扑工作队列。

BeginRegisterTopologyWorkQueuesWithMMCSS 方法是异步的。 操作完成后，将调用回调对象的 IMFAsyncCallback：：Invoke 方法。 在回调方法中，调用 IMFWorkQueueServices：：EndRegisterTopologyWorkQueuesWithMMCSS 以完成异步请求。 此操作完成后，媒体会话会自动为在媒体会话上排队的每个新拓扑注册工作队列。 对于新拓扑，应用程序不需要再次调用 方法。

若要从 MMCSS 取消注册拓扑工作队列，请调用 IMFWorkQueueServices：：BeginUnregisterTopologyWorkQueuesWithMMCSS。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	mfidl.h
Library	Mfuuid.lib

另请参阅

IMFWorkQueueServices