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

Um método IStiUSD::SetNotificationHandle de um minidriver de imagem ainda especifica um identificador de evento que o minidriver deve usar para informar o chamador de eventos do dispositivo.

Sintaxe

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parâmetros

hEvent

Identificador fornecido pelo chamador para um evento Win32, criado chamando CreateEvent.

Retornar valor

Se a operação for bem-sucedida, o método deverá retornar S_OK. Caso contrário, ele deverá retornar um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

Se o driver (e o dispositivo) der suporte à notificação assíncrona de Eventos de Dispositivo de Imagem Ainda, o método IStiUSD::SetNotificationHandle do minidriver será o meio pelo qual o monitor do evento solicita que o driver o notifique quando ocorrer um evento.

Se hEvent for um identificador de evento, o método IStiUSD::SetNotificationHandle deverá armazenar o identificador e usá-lo como um argumento de entrada para SetEvent (descrito na documentação do SDK do Microsoft Windows). O driver deve chamar SetEvent sempre que um evento de dispositivo for detectado, para notificar o monitor do evento de que ocorreu um evento.

Se hEvent for NULL, o método deverá desabilitar a notificação de eventos do dispositivo.

Requisitos