Metodo IStiUSD::SetNotificationHandle (stiusd.h)

Un minidriver dell'immagine metodo IStiUSD::SetNotificationHandle 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 con prefisso STIERR definiti in stierr.h.

Osservazioni

Se il driver (e il dispositivo) supporta la notifica asincrona di Still Image Device Events, il metodo IStiUSD::SetNotificationHandle del minidriver 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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	stiusd.h (include Stiusd.h)