Fungsi MFPutWaitingWorkItem (mfapi.h)

Mengantrekan item kerja yang menunggu peristiwa disinyalir.

Syntax

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

Parameter-parameternya

[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 dapat null.

Mengembalikan nilai

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

Komentar

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 disinyalir, item kerja memanggil panggilan balik. (Panggilan balik terkandung dalam objek hasil yang diberikan di 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]
Platform Target	Windows
Header	mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll

Lihat juga

Fungsi Media Foundation

Peningkatan Antrean dan Utas Kerja

Antrean Kerja