Bagikan melalui

Fungsi EngMapEvent (winddi.h)

  • Artikel

Fungsi EngMapEvent memetakan objek peristiwa mode pengguna ke mode kernel.

Sintaks

ENGAPI PEVENT EngMapEvent(
  [in] HDEV   hDev,
  [in] HANDLE hUserObject,
       PVOID  Reserved1,
       PVOID  Reserved2,
       PVOID  Reserved3
);

Parameter

[in] hDev

Tangani ke perangkat fisik yang terkait dengan peristiwa. Ini adalah handel GDI yang diteruskan sebagai parameter hdev ke fungsi DrvCompletePDEV driver.

[in] hUserObject

Tangani ke peristiwa mode pengguna yang akan dipetakan.

Reserved1

Dicadangkan untuk penggunaan sistem, dan harus diatur ke NULL.

Reserved2

Dicadangkan untuk penggunaan sistem, dan harus diatur ke NULL.

Reserved3

Dicadangkan untuk penggunaan sistem, dan harus diatur ke NULL.

Menampilkan nilai

EngMapEvent mengembalikan penunjuk ke objek peristiwa saat berhasil. Jika tidak, ia mengembalikan NULL.

Keterangan

Setelah berhasil memetakan peristiwa pengguna, EngMapEvent secara otomatis mengatur objek peristiwa ke status bersinyali, mencoba untuk memenuhi sebanyak mungkin tunggu, lalu mengatur ulang objek peristiwa ke status tidak bertanda.

Peristiwa yang dipetakan menyediakan mekanisme di mana aplikasi dapat menunggu operasi grafis mode kernel selesai. Driver tampilan atau driver miniport video memberi sinyal aplikasi ketika dilakukan menggunakan sumber daya tempat peristiwa dipetakan, sehingga membebaskan aplikasi untuk menggunakan sumber daya.

Driver tampilan dan miniport tidak dapat menunggu peristiwa yang dipetakan, tetapi dapat mengatur atau menghapusnya.

Driver juga dapat melakukan pembersihan sendiri dengan memanggil EngUnmapEvent pada objek peristiwa yang dikembalikan oleh 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

Lihat juga

DrvCompletePDEV

EngUnmapEvent