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

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

Sintaxis

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parámetros

hEvent

Identificador proporcionado por el autor de la llamada a un evento Win32, creado mediante una llamada 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.

Comentarios

Si el controlador (y el dispositivo) admiten notificaciones asincrónicas de eventos de dispositivo de imagen fija, el método IStiUSD::SetNotificationHandle del minidriver es el medio por el que el monitor de eventos solicita al controlador que lo notifique cuando se produzca 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 (descrito en la documentación de Microsoft Windows SDK). 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

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	stiusd.h (incluya Stiusd.h)