Metode IStiUSD::SetNotificationHandle (stiusd.h)

Metode IStiUSD::SetNotificationHandle minidriver gambar masih menentukan penanganan peristiwa yang harus digunakan minidriver untuk memberi tahu pemanggil peristiwa perangkat.

Sintaks

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parameter

hEvent

Handel yang disediakan penelepon ke acara Win32, dibuat dengan memanggil CreateEvent.

Nilai kembali

Jika operasi berhasil, metode harus mengembalikan S_OK. Jika tidak, itu harus mengembalikan salah satu kode kesalahan awalan STIERR yang ditentukan dalam stierr.h.

Keterangan

Jika driver (dan perangkat) mendukung pemberitahuan asinkron Peristiwa Perangkat Gambar Diam, metode IStiUSD::SetNotificationHandle minidriver adalah sarana di mana pemantau peristiwa meminta driver untuk memberi tahunya ketika suatu peristiwa terjadi.

Jika hEvent adalah penanganan peristiwa, metode IStiUSD::SetNotificationHandle harus menyimpan handel dan menggunakannya sebagai argumen input ke SetEvent (dijelaskan dalam dokumentasi Microsoft Windows SDK). Driver harus memanggil SetEvent setiap kali peristiwa perangkat terdeteksi, untuk memberi tahu pemantau peristiwa bahwa peristiwa telah terjadi.

Jika hEventADALAH NULL, metode harus menonaktifkan pemberitahuan peristiwa perangkat.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	stiusd.h (termasuk Stiusd.h)