Método IWiaDevMgr2::RegisterEventCallbackCLSID

O método IWiaDevMgr2::RegisterEventCallbackCLSID registra um aplicativo para receber eventos mesmo que o aplicativo não esteja em execução.

Sintaxe

HRESULT RegisterEventCallbackCLSID(
  [in]               LONG lFlags,
  [in]               BSTR bstrDeviceID,
  [in]         const GUID *pEventGUID,
  [in, unique] const GUID *pClsID,
  [in]               BSTR bstrName,
  [in]               BSTR bstrDescription,
  [in]               BSTR bstrIcon
);

Parâmetros

lFlags [in]

Tipo: LONG

Especifica sinalizadores de registro. Pode ser definido com os seguintes valores:

Sinalizador de registro	Significado
WIA_REGISTER_EVENT_CALLBACK	Registrar-se para o evento.
WIA_UNREGISTER_EVENT_CALLBACK	Exclua o registro do evento.
WIA_SET_DEFAULT_HANDLER	Defina o aplicativo como o manipulador de eventos padrão.

 

bstrDeviceID [in]

Tipo: BSTR

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

pEventGUID [in]

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.

pClsID [in]

Tipo: const GUID*

Ponteiro para a ID da classe de aplicativo (CLSID). O sistema de tempo de execução WIA 2.0 usa o CLSID do aplicativo para iniciar o aplicativo quando ocorre um evento para o qual ele está registrado.

bstrName [in]

Tipo: BSTR

Especifica o nome do aplicativo que se registra para o evento.

bstrDescription [in]

Tipo: BSTR

Especifica uma descrição de texto do aplicativo que se registra para o evento.

bstrIcon [in]

Tipo: BSTR

Especifica o nome de um arquivo de imagem a ser usado para o ícone do aplicativo que se registra para o evento.

Valor retornado

Tipo: HRESULT

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

Comentários

Os aplicativos WIA 2.0 usam esse método para se registrar para receber eventos de dispositivo de hardware. Depois que IWiaDevMgr2::RegisterEventCallbackCLSID for chamado, o aplicativo será registrado para receber eventos de dispositivo WIA 2.0 mesmo que ele não esteja em execução.

Quando o evento ocorre, o sistema WIA 2.0 determina qual aplicativo está registrado para receber o evento. Ele usa a função CoCreateInstance e o CLSID especificados no parâmetro pClsID para criar uma instância do aplicativo e, em seguida, chama o método ImageEventCallback para transmitir as informações do evento para o aplicativo.

Um aplicativo pode invocar o método EnumRegisterEventInfo para enumerar informações de registro de evento.

Se o aplicativo não for um componente COM (Component Object Model) registrado e não for compatível com a arquitetura do WIA 2.0, use o método IWiaDevMgr2::RegisterEventCallbackProgram para registrar um aplicativo para eventos de dispositivo.

Observação

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

 

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Wia.h