Método IWiaDevMgr2::RegisterEventCallbackProgram
O método IWiaDevMgr2::RegisterEventCallbackProgram registra um aplicativo para receber eventos de dispositivo. Ele é fornecido principalmente para compatibilidade com versões anteriores com aplicativos que não foram gravados para o Windows Image Acquisition (WIA) 2.0.
Sintaxe
HRESULT RegisterEventCallbackProgram(
[in] LONG lFlags,
[in] BSTR bstrDeviceID,
[in] const GUID *pEventGUID,
[in] BSTR bstrFullAppName,
[in] BSTR bstrCommandlineArg,
[in] BSTR bstrName,
[in] BSTR bstrDescription,
[in] BSTR bstrIcon
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Os sinalizadores de registro. Pode ser definido com os valores a seguir.
Valor 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
Um identificador de dispositivo. Passe NULL para se registrar para o evento em todos os dispositivos WIA 2.0.
-
pEventGUID [in]
-
Tipo: const GUID*
O evento para o qual o aplicativo está se registrando. Para obter uma lista de GUIDs de evento válidos, consulte Identificadores de eventos WIA.
-
bstrFullAppName [in]
-
Tipo: BSTR
O nome completo do caminho do aplicativo.
-
bstrCommandlineArg [in]
-
Tipo: BSTR
Os argumentos de linha de comando apropriados para o aplicativo.
-
bstrName [in]
-
Tipo: BSTR
O nome do aplicativo. O nome é exibido para o usuário quando vários aplicativos se registram para o mesmo evento.
-
bstrDescription [in]
-
Tipo: BSTR
A descrição do aplicativo. A descrição é exibida para o usuário quando vários aplicativos se registram para o mesmo evento.
-
bstrIcon [in]
-
Tipo: BSTR
O ícone que representa o aplicativo. O ícone é exibido para o usuário quando vários aplicativos se registram para o mesmo evento. A cadeia de caracteres contém o nome do aplicativo e o índice baseado em zero do ícone separado por uma vírgula, por exemplo, "MyApp, 0". Pode haver mais de um ícone que representa um aplicativo.
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
Use IWiaDevMgr2::RegisterEventCallbackProgram para se registrar em eventos de dispositivo de hardware. Quando ocorre um evento para o qual um aplicativo está registrado, o aplicativo é iniciado e as informações do evento são transmitidas para o aplicativo.
Use o método EnumRegisterEventInfo para recuperar um ponteiro para um objeto enumerador para propriedades de registro de evento.
Use apenas o método IWiaDevMgr2::RegisterEventCallbackProgram para compatibilidade com versões anteriores com aplicativos não gravados para a arquitetura WIA 2.0. Use as interfaces COM (Component Object Model) fornecidas pela arquitetura WIA 2.0 para novos aplicativos. Especificamente, chame IWiaDevMgr2::RegisterEventCallbackInterface ou IWiaDevMgr2::RegisterEventCallbackCLSID para registrar um novo aplicativo para eventos de dispositivo.
Normalmente, esse método é chamado por um programa de instalação ou um script. O programa de instalação ou script registra o aplicativo para receber eventos de dispositivo WIA 2.0. Quando o evento ocorre, o aplicativo é iniciado pelo sistema de tempo de execução WIA 2.0.
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 |
|