IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS 方法 (mfidl.h)
将拓扑工作队列注册到多媒体类计划程序服务 (MMCSS) 。
语法
HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
[in] IMFAsyncCallback *pCallback,
[in] IUnknown *pState
);
参数
[in] pCallback
指向回调对象的 IMFAsyncCallback 接口的指针。 调用方必须实现此接口。
[in] pState
指向调用方定义的状态对象的 IUnknown 接口的指针。 此参数可以为 NULL。 可以使用此对象来保存状态信息。 调用回调时,对象将返回到调用方。
返回值
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
拓扑中的每个源节点定义拓扑的一个分支。 分支包括从该节点接收数据的每个拓扑节点。 应用程序可以为拓扑的每个分支分配其自己的工作队列,然后将这些工作队列与 MMCSS 任务相关联。
若要使用此方法,请执行以下步骤。
- 创建拓扑。
- 在拓扑中的源节点上设置以下属性。
- MF_TOPONODE_WORKQUEUE_ID。 指定工作队列的标识符。 媒体会话将分配新的工作队列。
- MF_TOPONODE_WORKQUEUE_MMCSS_CLASS。 指定 MMCSS 类。
- MF_TOPONODE_WORKQUEUE_MMCSS_TASKID。 指定 MMCSS 任务标识符 (可选) 。 如果未设置此属性,MMCSS 将分配新的任务标识符。
- 通过调用 IMFMediaSession::SetTopology 将拓扑排队。
- 等待具有MF_TOPOSTATUS_READY状态的 MESessionTopologyStatus 事件。
- 调用 BeginRegisterTopologyWorkQueuesWithMMCSS。 此方法向 MMCSS 注册所有拓扑工作队列。
若要从 MMCSS 取消注册拓扑工作队列,请调用 IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | mfidl.h |
Library | Mfuuid.lib |