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. 在拓撲中的來源節點上設定下列屬性。
  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