Método IStiUSD::SetNotificationHandle (stiusd.h)

Un minidriver de imagen fija IStiUSD::SetNotificationHandle método especifica un identificador de eventos que el minidriver debe usar para informar al autor de la llamada de eventos del dispositivo.

Sintaxis

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parámetros

hEvent

Identificador proporcionado por el autor de la llamada a un evento Win32, creado llamando a CreateEvent.

Valor devuelto

Si la operación se realiza correctamente, el método debe devolver S_OK. De lo contrario, debe devolver uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Observaciones

Si el controlador (y el dispositivo) admiten la notificación asincrónica de Eventos de dispositivo still image, el método IStiUSD::SetNotificationHandle es el medio por el que el monitor de eventos solicita al controlador que lo notifique cuando se produce un evento.

Si hEvent es un identificador de eventos, el método IStiUSD::SetNotificationHandle debe almacenar el identificador y usarlo como argumento de entrada para SetEvent (que se describe en la documentación del SDK de Microsoft Windows). El controlador debe llamar a SetEvent cada vez que se detecta un evento de dispositivo para notificar al monitor de eventos que se ha producido un evento.

Si hEvent es NULL, el método debe deshabilitar la notificación de eventos de dispositivo.

Requisitos