Compartilhar via

Método IWiaDevMgr::RegisterEventCallbackInterface (wia_xp.h)

  • Artigo

O método IWiaDevMgr::RegisterEventCallbackInterface registra uma notificação de evento WIA (Aquisição de Imagens do Windows) do aplicativo em execução.

Sintaxe

HRESULT RegisterEventCallbackInterface(
  [in]  LONG              lFlags,
  [in]  BSTR              bstrDeviceID,
  [in]  const GUID        *pEventGUID,
  [in]  IWiaEventCallback *pIWiaEventCallback,
  [out] IUnknown          **pEventObject
);

Parâmetros

[in] lFlags

Tipo: LONG

Atualmente não utilizado. Deve ser definido como zero.

[in] bstrDeviceID

Tipo: BSTR

Especifica um identificador de dispositivo. Passe NULL para se registrar para o evento em todos os dispositivos WIA.

[in] pEventGUID

Tipo: const GUID*

Especifica o evento para o qual o aplicativo está se registrando. Para obter uma lista de eventos padrão, consulte Identificadores de eventos WIA.

[in] pIWiaEventCallback

Tipo: IWiaEventCallback*

Ponteiro para a interface IWiaEventCallback que o sistema WIA usou para enviar a notificação de evento.

[out] pEventObject

Tipo: IUnknown**

Recebe o endereço de um ponteiro para a interface IUnknown .

Retornar valor

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

Aviso Usar os métodos IWiaDevMgr::RegisterEventCallbackInterface, IWiaDevMgr2::RegisterEventCallbackInterface e DeviceManager.RegisterEvent do mesmo processo após a reinicialização do Serviço de Imagem Ainda poderá causar uma violação de acesso, se as funções forem usadas antes de o serviço ser interrompido.
 
Quando eles começam a ser executados, os aplicativos WIA usam esse método para se registrar para receber eventos de dispositivo de hardware do tipo WIA_NOTIFICATION_EVENT. Isso impede que o aplicativo seja reiniciado quando ocorrer outro evento para o qual ele está registrado. Depois que um programa invoca IWiaDevMgr::RegisterEventCallbackInterface para se registrar para receber eventos WIA de um dispositivo, os eventos registrados são roteados para o programa pelo sistema WIA.

Os aplicativos usam o método EnumRegisterEventInfo para recuperar um ponteiro para um objeto enumerador para propriedades de registro de evento.

Um aplicativo pode descobrir se um evento é um tipo de ação ou um evento de tipo de notificação (ou ambos) examinando o valor ulFlags de uma estrutura WIA_DEV_CAP retornada por enumeração de evento.

Os aplicativos podem cancelar o registro de eventos usando o ponteiro IUnknown retornado por meio do parâmetro pEventObject para chamar o método IUnknown::Release .

Nota Em um aplicativo multi-threaded, não há garantia de que o retorno de chamada de notificação de evento entrará no mesmo thread que registrou o retorno de chamada.
 

Requisitos

Requisito Valor
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
DLL Wiaservc.dll