Fungsi MFPutWaitingWorkItem (mfapi.h)

Artikel
03/04/2024

Mengantrekan item kerja yang menunggu peristiwa disinyalkan.

Sintaks

HRESULT MFPutWaitingWorkItem(
  [in]  HANDLE         hEvent,
  [in]  LONG           Priority,
  [in]  IMFAsyncResult *pResult,
  [out] MFWORKITEM_KEY *pKey
);

Parameter

[in] hEvent

Handel ke objek peristiwa. Untuk membuat objek peristiwa, panggil CreateEvent atau CreateEventEx.

[in] Priority

Prioritas item kerja. Item kerja dilakukan dalam urutan prioritas.

[in] pResult

Penunjuk ke antarmuka IMFAsyncResult dari objek hasil asinkron. Untuk membuat objek hasil, panggil MFCreateAsyncResult.

[out] pKey

Menerima kunci yang dapat digunakan untuk membatalkan penantian. Untuk membatalkan tunggu, panggil MFCancelWorkItem dan teruskan kunci ini di parameter Kunci .

Parameter ini bisa NULL.

Mengembalikan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi ini memungkinkan komponen untuk menunggu peristiwa tanpa memblokir utas saat ini.

Fungsi ini menempatkan item kerja pada antrean kerja yang ditentukan. Item kerja ini menunggu peristiwa yang diberikan dalam hEvent untuk diberi sinyal. Saat peristiwa disinyalkan, item kerja memanggil panggilan balik. (Panggilan balik terkandung dalam objek hasil yang diberikan dalam pResult. Untuk informasi selengkapnya, lihat MFCreateAsyncResult).

Item kerja dikirim pada antrean kerja oleh metode IMFAsyncCallback::GetParameters dari panggilan balik. Antrean kerja dapat berupa salah satu hal berikut:

Antrean kerja default (MFASYNC_CALLBACK_QUEUE_STANDARD).
Antrean multithread platform (MFASYNC_CALLBACK_QUEUE_MULTITHREADED).
Antrean multithread yang dikembalikan oleh fungsi MFLockSharedWorkQueue .
Antrean serial yang dibuat oleh fungsi MFAllocateSerialWorkQueue .

Jangan gunakan salah satu antrean kerja berikut: MFASYNC_CALLBACK_QUEUE_IO, MFASYNC_CALLBACK_QUEUE_LONG_FUNCTION, MFASYNC_CALLBACK_QUEUE_RT, atau MFASYNC_CALLBACK_QUEUE_TIMER.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfapi.h
DLL	Mfplat.dll

Lihat juga

Fungsi Media Foundation

Peningkatan Antrean kerja dan Utas

Antrean Kerja

Share via