MFPutWorkItem 函式 (mfapi.h)

將異步操作放在工作佇列上。

語法

HRESULT MFPutWorkItem(
  [in] DWORD            dwQueue,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

[in] dwQueue

工作佇列的標識碼。此值可以指定其中一個標準 Media Foundation 工作佇列，或應用程式建立的工作佇列。如需標準媒體基礎工作佇列的清單，請參閱工作佇列標識碼。若要建立新的工作佇列，請呼叫 MFAllocateWorkQueue 或 MFAllocateWorkQueueEx。

[in] pCallback

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

[in] pState

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

傳回 HRESULT 值。可能的值如下。

傳回碼	Description
S_OK	成功。
MF_E_INVALID_WORKQUEUE	無效的工作佇列。如需詳細資訊，請參閱 IMFAsyncCallback：：GetParameters。
MF_E_SHUTDOWN	未呼叫 MFStartup 函式，或呼叫 MFShutdown 。

此函式會建立異步的結果物件，並將結果物件放在工作佇列上。工作佇列會呼叫 pCallback 所指定的 IMFAsyncCallback：：Invoke 方法。