Método IWiaDevMgr2::RegisterEventCallbackInterface
Registra um aplicativo em execução para a notificação de evento WIA (Aquisição de Imagens do Windows) 2.0.
Sintaxe
HRESULT RegisterEventCallbackInterface(
[in] LONG lFlags,
[in] BSTR bstrDeviceID,
[in] const GUID *pEventGUID,
[in] IWiaEventCallback *pIWiaEventCallback,
[out] IUnknown **pEventObject
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Atualmente não utilizado. Deve ser definido como zero.
-
bstrDeviceID [in]
-
Tipo: BSTR
Especifica o identificador exclusivo de um dispositivo WIA 2.0. Defina esse parâmetro como NULL para registrar o evento em todos os dispositivos WIA 2.0.
-
pEventGUID [in]
-
Tipo: const GUID*
Especifica um ponteiro para o identificador de evento para o qual o aplicativo está se registrando. Consulte Identificadores de eventos WIA para obter identificadores de eventos padrão.
-
pIWiaEventCallback [in]
-
Tipo: IWiaEventCallback*
Especifica um ponteiro para a interface IWiaEventCallback que o WIA 2.0 usa para enviar notificação de evento.
-
pEventObject [out]
-
Tipo: IUnknown**
Recebe o endereço de um ponteiro para a interface IUnknown .
Valor retornado
Tipo: HRESULT
Retorna os códigos de erro COM padrão ou o seguinte.
| Código de retorno | Descrição |
|---|---|
|
A interface IUnknown não pode ser retornada. |
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 os aplicativos WIA 2.0 começam a ser executados, eles usam esse método para se registrar para receber eventos de dispositivo de hardware. Isso impede que o aplicativo seja reiniciado quando ocorrer outro evento para o qual ele está registrado. Depois que um aplicativo chama IWiaDevMgr2::RegisterEventCallbackInterface para se registrar para receber eventos WIA 2.0 de um dispositivo, os eventos registrados são roteados para o programa pelo WIA 2.0.
Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro pEventObject .
Observação
Em um aplicativo multithread, o retorno de chamada de notificação de evento pode vir em um thread diferente daquele 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 |
|
| IDL |
|