MFAllocateWorkQueueEx 函式 (mfapi.h)

建立新的工作佇列。此函式可藉由建立具有訊息迴圈的工作佇列，來擴充 MFAllocateWorkQueue 函式的功能。

語法

HRESULT MFAllocateWorkQueueEx(
  [in]  MFASYNC_WORKQUEUE_TYPE WorkQueueType,
  [out] DWORD                  *pdwWorkQueue
);

[in] WorkQueueType

MFASYNC_WORKQUEUE_TYPE列舉的成員，指定要建立的工作佇列類型。

值	意義
MF_MULTITHREADED_WORKQUEUE	建立多線程工作佇列。一般而言，應用程式不應該建立私人多線程佇列。請改用平臺多線程佇列。如需詳細資訊，請參閱工作佇列和線程改善。
MF_STANDARD_WORKQUEUE	建立不含訊息迴圈的工作佇列。使用此旗標相當於呼叫 MFAllocateWorkQueue。
MF_WINDOW_WORKQUEUE	使用訊息迴圈建立工作佇列。分派此佇列工作項目的線程也會呼叫 PeekMessage 和 DispatchMessage。如果您的回呼執行任何需要訊息循環的動作，請使用此選項。

[out] pdwWorkQueue

接收已建立之工作佇列的標識碼。

函式會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

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

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

MFAllocateWorkQueue 函式相當於使用 WorkQueueType 參數的值MF_STANDARD_WORKQUEUE呼叫 MFAllocateWorkQueueEx。

如果已安裝適用於 Windows Vista 的平臺更新補充，此函式可在 Windows Vista 上使用。

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新補充 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	mfapi.h
程式庫	Mfplat.lib
Dll	Mfplat.dll