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 |