Compartilhar via

Método IWiaEventCallback::ImageEventCallback (wia_xp.h)

  • Artigo

O método IWiaEventCallback::ImageEventCallback é invocado pelo sistema de tempo de execução WIA (Aquisição de Imagens do Windows) quando ocorre um evento de dispositivo de hardware.

Sintaxe

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

Parâmetros

[in] pEventGUID

Tipo: const GUID*

Especifica o identificador exclusivo do evento. Para obter uma lista completa de eventos de dispositivo, consulte Identificadores de eventos wia.

[in] bstrEventDescription

Tipo: BSTR

Especifica a descrição da cadeia de caracteres do evento.

[in] bstrDeviceID

Tipo: BSTR

Especifica o identificador exclusivo do dispositivo WIA.

[in] bstrDeviceDescription

Tipo: BSTR

Especifica a descrição da cadeia de caracteres do dispositivo.

[in] dwDeviceType

Tipo: DWORD

Especifica o tipo do dispositivo. Consulte Especificadores de tipo de dispositivo WIA para obter uma lista de valores possíveis.

[in] bstrFullItemName

Tipo: BSTR

Especifica o nome completo do item WIA que representa o dispositivo.

[in, out] pulEventType

Tipo: ULONG*

Ponteiro para um ULONG que especifica se um evento é um evento de notificação, um evento de ação ou ambos. Um valor de 1 indica um evento de notificação, um valor de 2 indica um evento de ação e um valor de 3 indica que o evento é do tipo de notificação e ação.

[in] ulReserved

Tipo: ULONG

Reservado para informações do usuário.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para receber a notificação de eventos de dispositivo de hardware WIA, os aplicativos passam um ponteiro para a interface IWiaEventCallback para o método RegisterEventCallbackInterface . Em seguida, o sistema de tempo de execução wia usa esse ponteiro de interface para invocar o método IWiaEventCallback::ImageEventCallback sempre que ocorrer um evento de dispositivo de hardware WIA.

Observe que não há nenhuma garantia de que o retorno de chamada será invocado no mesmo thread que registrou a interface IWiaEventCallback .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib