共用方式為


MFAllocateSerialWorkQueue 函式 (mfapi.h)

建立保證序列化工作專案的工作佇列。 序列工作佇列會包裝現有的多執行緒工作佇列。 序列工作佇列會強制執行先進先出 (FIFO) 執行順序。

語法

HRESULT MFAllocateSerialWorkQueue(
  [in]  DWORD dwWorkQueue,
  [out] DWORD *pdwWorkQueue
);

參數

[in] dwWorkQueue

現有工作佇列的識別碼。 這必須是多執行緒佇列或其他序列工作佇列。 您可以使用下列任一項:

  • 預設工作佇列 (MFASYNC_CALLBACK_QUEUE_STANDARD)
  • 平臺多執行緒佇列 (MFASYNC_CALLBACK_QUEUE_MULTITHREADED)
  • MFLockSharedWorkQueue函式傳回的多執行緒佇列。
  • MFAllocateSerialWorkQueue函式所建立的序列佇列。

[out] pdwWorkQueue

接收新序列工作佇列的識別碼。 將工作專案排入佇列時,請使用此識別碼。

傳回值

此函式可以傳回下列其中一個值。

傳回碼 描述
S_OK
此函數已成功。
E_FAIL
應用程式超過工作佇列的數目上限。
MF_E_SHUTDOWN
應用程式未呼叫 MFStartup,或應用程式已經呼叫 MFShutdown

備註

當您使用工作佇列完成時,請呼叫 MFUnlockWorkQueue

多執行緒佇列會使用執行緒集區,以減少管線中的執行緒總數。 不過,它們不會序列化工作專案。 序列工作佇列可讓應用程式取得執行緒集區的優點,而不需要執行自己的工作專案的手動序列化。

回復模式

序列化程式佇列也可以在「回復」模式中運作。 如果呼叫端的 IMFAsyncCallback::GetParameters 方法傳回 MFASYNC_REPLY_CALLBACK 旗標,序列化程式佇列不會自動前進到下一個工作專案。 相反地,佇列會等候來電者的回復。 呼叫端會叫用工作佇列傳遞至 Invoke 方法的非同步結果物件,以發出回復的訊號。 下列程式碼說明呼叫端如何發出工作佇列的訊號。
HRESULT CCallback::Invoke(IMFAsyncResult *pResult)
{
    DoSomeWork();
    
    // Reply to the work queue that you are done.
    MFInvokeCallback(pResult);

    // Note: This call to MFInvokeCallback does not have to occur inside the
    // Invoke method. You could call MFInvokeCallback at a later time. 

    return S_OK;
}
HRESULT CCallback::GetParameters(DWORD *pdwFlags, DWORD *pdwQueue)
{
    *pdwFlags = MFASYNC_REPLY_CALLBACK;
    *pdwQueue = m_QueueId;
    return S_OK;
}

需求

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

另請參閱

媒體基礎函式

工作佇列和執行緒改善