Fungsi MFAllocateWorkQueueEx (mfapi.h)

Membuat antrean kerja baru. Fungsi ini memperluas kemampuan fungsi MFAllocateWorkQueue dengan memungkinkan untuk membuat antrean kerja yang memiliki perulangan pesan.

Sintaks

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

Parameter

[in] WorkQueueType

Anggota enumerasi MFASYNC_WORKQUEUE_TYPE , menentukan jenis antrean kerja yang akan dibuat.

Nilai	Makna
MF_MULTITHREADED_WORKQUEUE	Buat antrean kerja multithreaded. Umumnya, aplikasi tidak boleh membuat antrean multithread privat. Gunakan antrean multithread platform sebagai gantinya. Untuk informasi selengkapnya, lihat Antrean Kerja dan Peningkatan Utas.
MF_STANDARD_WORKQUEUE	Buat antrean kerja tanpa perulangan pesan. Menggunakan bendera ini setara dengan memanggil MFAllocateWorkQueue.
MF_WINDOW_WORKQUEUE	Buat antrean kerja dengan perulangan pesan. Utas yang mengirimkan item kerja untuk antrean ini juga akan memanggil PeekMessage dan DispatchMessage. Gunakan opsi ini jika panggilan balik Anda melakukan tindakan apa pun yang memerlukan perulangan pesan.

[out] pdwWorkQueue

Menerima pengidentifikasi untuk antrean kerja yang dibuat.

Mengembalikan nilai

Fungsi mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Fungsi berhasil.
E_FAIL	Aplikasi melebihi jumlah maksimum antrean kerja.
E_INVALIDARG	Argumen tidak valid.
MF_E_SHUTDOWN	Aplikasi tidak memanggil MFStartup, atau aplikasi telah memanggil MFShutdown.

Keterangan

Setelah selesai menggunakan antrean kerja, panggil MFUnlockWorkQueue.

Fungsi MFAllocateWorkQueue setara dengan memanggil MFAllocateWorkQueueEx dengan nilai MF_STANDARD_WORKQUEUE untuk parameter WorkQueueType .

Fungsi ini tersedia di Windows Vista jika Suplemen Pembaruan Platform untuk Windows Vista diinstal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista, dan Suplemen Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfapi.h
Pustaka	Mfplat.lib
DLL	Mfplat.dll

Lihat juga

MFPutWorkItem

MFPutWorkItemEx

Fungsi Media Foundation

Antrean Kerja