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
程式庫	Mfuuid.lib

另請參閱

IMFWorkQueueServices