Bagikan melalui

Fungsi MFAllocateWorkQueueEx (mfapi.h)

  • Artikel

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