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 |
---|---|
|
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. |
|
Buat antrean kerja tanpa perulangan pesan. Menggunakan bendera ini setara dengan memanggil MFAllocateWorkQueue. |
|
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 |
---|---|
|
Fungsi berhasil. |
|
Aplikasi melebihi jumlah maksimum antrean kerja. |
|
Argumen tidak valid. |
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk