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

Artigo
02/07/2025

O 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.

Valor de retorno

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.

Observações

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 de eventos solicitará 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 de eventos de que ocorreu um evento.

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	stiusd.h (inclua Stiusd.h)

Compartilhar via