Interface IWiaItem (wia_xp.h)

Cada dispositivo de hardware WIA (Aquisição de Imagens do Windows) é representado para um aplicativo como uma árvore hierárquica de objetos IWiaItem . A interface IWiaItem fornece aos aplicativos a capacidade de consultar dispositivos para descobrir seus recursos. Ele também fornece acesso a interfaces de transferência de dados e propriedades de item. Além disso, a interface IWiaItem fornece métodos para permitir que os aplicativos controlem o dispositivo.

Nota Para aplicativos do Windows Vista, use IWiaItem2 em vez de IWiaItem.
 

Herança

A interface IWiaItem herda da interface IUnknown . O IWiaItem também tem esses tipos de membros:

Métodos

A interface IWiaItem tem esses métodos.

 
IWiaItem::AnalyzeItem

O método IWiaItem::AnalyzeItem faz com que o dispositivo de hardware WIA (Aquisição de Imagens do Windows) adquira e tente detectar quais tipos de dados estão presentes.
IWiaItem::CreateChildItem

O método IWiaItem::CreateChildItem é usado por aplicativos para adicionar objetos IWiaItem à árvore IWiaItem de um dispositivo.
IWiaItem::D eleteItem

O método IWiaItem::D eleteItem remove o objeto IWiaItem atual da árvore de objetos do dispositivo.
IWiaItem::D eviceCommand

O IWiaItem::D eviceCommand emite um comando para um dispositivo de hardware WIA (Aquisição de Imagens do Windows).
IWiaItem::D eviceDlg

O método IWiaItem::D eviceDlg é usado por aplicativos para exibir uma caixa de diálogo para o usuário se preparar para a aquisição de imagens.
IWiaItem::D iagnostic

Não há suporte para o método. (IWiaItem.Diagnostic)
IWiaItem::D umpDrvItemData

Não há suporte para o método. (IWiaItem.DumpDrvItemData)
IWiaItem::D umpItemData

Não há suporte para o método. (IWiaItem.DumpItemData)
IWiaItem::D umpTreeItemData

Não há suporte para o método. (IWiaItem.DumpTreeItemData)
IWiaItem::EnumChildItems

O método IWiaItem::EnumChildItems cria um objeto enumerador e passa um ponteiro para sua interface IEnumWiaItem para pastas não vazias em uma árvore IWiaItem de um dispositivo WIA (Aquisição de Imagens do Windows).
IWiaItem::EnumDeviceCapabilities

O método IWiaItem::EnumDeviceCapabilities cria um enumerador usado para verificar os comandos e eventos compatíveis com um dispositivo WIA (Aquisição de Imagens do Windows).
IWiaItem::EnumRegisterEventInfo

O método IWiaItem::EnumRegisterEventInfo cria um enumerador usado para obter informações sobre eventos para os quais um aplicativo está registrado.
IWiaItem::FindItemByName

O método IWiaItem::FindItemByName pesquisa a árvore de subitens de um item usando o nome como a chave de pesquisa. Cada objeto IWiaItem tem um nome como uma de suas propriedades padrão.
IWiaItem::GetItemType

O método IWiaItem::GetItemType é chamado por aplicativos para obter as informações de tipo de um item.
IWiaItem::GetRootItem

O método IWiaItem::GetRootItem recupera o item raiz de uma árvore de objetos de item usada para representar um dispositivo de hardware WIA (Aquisição de Imagens do Windows).

Comentários

Alguns dos métodos da interface IWiaItem são válidos apenas no item raiz da árvore do dispositivo. Outros métodos são válidos em todos os itens. Os métodos são agrupados da seguinte maneira:

Válido somente no item raiz IWiaItem::D eviceCommand
  IWiaItem::D eviceDlg
  IWiaItem::EnumDeviceCapabilities
  IWiaItem::EnumRegisterEventInfo
Válido em todos os itens IWiaItem::AnalyzeItem
  IWiaItem::CreateChildItem
  IWiaItem::D eleteItem
  IWiaItem::EnumChildItems
  IWiaItem::FindItemByName
  IWiaItem::GetItemType
  IWiaItem::GetRootItem
 

A interface IWiaItem , como todas as interfaces COM (Component Object Model), herda os métodos de interface IUnknown .

Métodos IUnknown Descrição
IUnknown::QueryInterface Retorna ponteiros para interfaces com suporte.
IUnknown::AddRef Incrementa a contagem de referência.
IUnknown::Release Contagem de referência decrementos.

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)