Fungsi EngWaitForSingleObject (winddi.h)
Fungsi EngWaitForSingleObject menempatkan utas driver tampilan saat ini ke dalam status tunggu hingga objek peristiwa yang ditentukan diatur ke status tersinyal, atau hingga waktu tunggu habis.
Sintaks
ENGAPI BOOL EngWaitForSingleObject(
[in] PEVENT pEvent,
[in] PLARGE_INTEGER pTimeOut
);
Parameter
[in] pEvent
Penunjuk ke objek peristiwa yang diinisialisasi. Handel objek kejadian ini diperoleh dalam panggilan sebelumnya ke EngCreateEvent.
[in] pTimeOut
(Opsional) Penunjuk ke nilai waktu habis yang menentukan waktu absolut atau relatif di mana penantian akan selesai. Nilai negatif menentukan interval relatif terhadap waktu saat ini. Nilai harus dinyatakan dalam satuan 100 nanodetik. Waktu kedaluwarsa absolut melacak perubahan apa pun dalam waktu sistem; waktu kedaluwarsa relatif tidak terpengaruh oleh perubahan waktu sistem. Jika pTimeOutNULL, utas panggilan tetap dalam status menunggu hingga objek peristiwa disinyalkan.
Menampilkan nilai
EngWaitForSingleObject mengembalikan TRUE setelah berhasil, yang mencakup terjadinya waktu habis. Jika tidak, ia mengembalikan FALSE. Nilai pengembalian FALSE menunjukkan bahwa salah satu parameter tidak valid.
Keterangan
EngWaitForSingleObject menyebabkan utas driver tampilan dimasukkan ke dalam status tunggu. Utas driver tampilan tetap dalam status tunggu hingga objek peristiwa diatur ke status bersinyali atau hingga waktu tunggu habis. Jika tidak ada nilai waktu habis yang disediakan, utas driver tampilan tetap dalam status tunggu hingga objek peristiwa diatur ke status tersinyal.
Peristiwa sinkronisasi secara otomatis diatur ulang ke status tidak bertanda ketika waktu tunggu terpenuhi. Dengan demikian, hanya satu tunggu yang akan terpenuhi per panggilan ke EngSetEvent atau VideoPortSetEvent. Sebaliknya, peristiwa pemberitahuan tidak akan direset secara otomatis.
Nilai waktu habis nol memungkinkan driver untuk menguji kondisi tunggu dan secara kondisional melakukan efek samping asalkan waktu tunggu dapat segera terpenuhi.
Driver tampilan dapat menyinkronkan operasi gambar antara dirinya sendiri dan driver miniport video dengan memanggil EngWaitForSingleObject dengan objek peristiwa, dan menunggu sampai driver miniport mengatur objek peristiwa ke status tersinyal.
Driver tidak dapat memanggil EngWaitForSingleObject pada peristiwa yang dikembalikan dari EngMapEvent.
Persyaratan
| Klien minimum yang didukung | Fungsi ini tersedia di Windows XP dan yang lebih baru. |
| Target Platform | Universal |
| Header | winddi.h (termasuk Winddi.h) |
| Pustaka | Win32k.lib |
| DLL | Win32k.sys |