Share via

MFBeginRegisterWorkQueueWithMMCSSEx 函式 (mfapi.h)

  • 發行項

將工作佇列與多媒體類別排程器服務建立關聯， (MMCSS) 工作。

語法

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

參數

[in] dwWorkQueueId

工作佇列的標識碼。 針對私人工作佇列，標識符會由 MFAllocateWorkQueue 函式傳回。 如需平臺工作佇列，請參閱 工作佇列標識碼。

[in] wszClass

MMCSS 工作的名稱。 如需詳細資訊，請參閱 多媒體類別排程器服務。

[in] dwTaskId

唯一的工作標識碼。 若要取得新的工作識別碼，請將此值設定為零。

[in] lPriority

工作佇列線程的基底相對優先順序。 如需詳細資訊，請參閱 AvSetMmThreadPriority。

[in] pDoneCallback

回 呼物件的 IMFAsyncCallback 介面指標。 呼叫端必須實作這個介面。

[in] pDoneState

狀態物件的 IUnknown 介面指標，由呼叫端定義。 此參數可以是 Null。 您可以使用這個物件來儲存狀態資訊。 叫用回呼時，物件會傳回給呼叫端。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此函式會藉由新增 lPriority 參數來擴充 MFBeginRegisterWorkQueueWithMMCSS 函式。

此函式是異步的。 當作業完成時，會呼叫回呼物件的 IMFAsyncCallback：：Invoke 方法。 此時，請呼叫 MFEndRegisterWorkQueueWithMMCSS 以完成異步要求。

若要從 MMCSS 工作取消註冊工作佇列，請呼叫 MFBeginUnregisterWorkQueueWithMMCSS。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfapi.h
Dll Mfplat.dll

另請參閱

媒體基礎函式

工作佇列和線程改善

工作佇列