Metodo IStiUSD::SetNotificationHandle (stiusd.h)

Un metodo IStiUSD::SetNotificationHandle di un'immagine continua specifica un handle di evento che il minidriver deve usare per informare il chiamante degli eventi del dispositivo.

Sintassi

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parametri

hEvent

Handle fornito dal chiamante a un evento Win32 creato chiamando CreateEvent.

Valore restituito

Se l'operazione ha esito positivo, il metodo deve restituire S_OK. In caso contrario, deve restituire uno dei codici di errore prefissi STIERR definiti in stierr.h.

Commenti

Se il driver (e il dispositivo) supporta la notifica asincrona degli eventi del dispositivo Still Image, il metodo IStiUSD::SetNotificationHandle è il mezzo in cui il monitoraggio eventi richiede al driver di notificarlo quando si verifica un evento.

Se hEvent è un handle eventi, il metodo IStiUSD::SetNotificationHandle deve archiviare l'handle e usarlo come argomento di input per SetEvent (descritto nella documentazione di Microsoft Windows SDK). Il driver deve chiamare SetEvent ogni volta che viene rilevato un evento del dispositivo, per notificare al monitoraggio eventi che si è verificato un evento.

Se hEvent è NULL, il metodo deve disabilitare la notifica degli eventi del dispositivo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	stiusd.h (include Stiusd.h)