Função wiasQueueEvent (wiamdef.h)

Artigo
02/07/2025

A função wiasQueueEvent informa ao serviço que o dispositivo gerou um evento.

Sintaxe

HRESULT wiasQueueEvent(
  [in]           BSTR       bstrDeviceId,
  [in]           const GUID *pEventGUID,
  [in, optional] BSTR       bstrFullItemName
);

Parâmetros

[in] bstrDeviceId

Especifica a ID do dispositivo. Esse é o valor passado para o minidriver na chamada para o método IWiaMiniDrv::d rvInitializeWia.

[in] pEventGUID

Ponteiro para um buffer que contém o GUID para o evento.

[in, optional] bstrFullItemName

Especifica o nome completo do item, incluindo informações de caminho.

Valor de retorno

Com êxito, a função retorna S_OK.

Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia .

Observações

Esse método deve ser usado sempre que o dispositivo deve sinalizar que ocorreu um evento de algum tipo. O dispositivo faz isso colocando o evento na fila de eventos. Por exemplo, quando uma câmera tira uma nova imagem, ela deve gerar um evento WIA_EVENT_ITEM_CREATED depois de adicionar um novo item de driver à árvore. A câmera pode colocar esse evento na fila de eventos dessa maneira:

hr = wiasQueueEvent(bstrMyDeviceId,
                    &WIA_EVENT_ITEM_CREATED,
                    bstrDescriptionString);

Consulte a documentação do SDK do Windows para obter uma lista completa de identificadores de eventos WIA.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wiamdef.h (inclua Wiamdef.h)
biblioteca	Wiaservc.lib
de DLL	Wiaservc.dll

Consulte também

IWiaMiniDrv::d rvInitializeWia

Compartilhar via