Método IWiaDevMgr::SelectDeviceDlg (wia_xp.h)

O IWiaDevMgr::SelectDeviceDlg exibe uma caixa de diálogo que permite que o usuário selecione um dispositivo de hardware para aquisição de imagem.

Sintaxe

HRESULT SelectDeviceDlg(
  [in]          HWND     hwndParent,
  [in]          LONG     lDeviceType,
  [in]          LONG     lFlags,
  [in, out]     BSTR     *pbstrDeviceID,
  [out, retval] IWiaItem **ppItemRoot
);

Parâmetros

[in] hwndParent

Digite: HWND

Identificador da janela que possui a caixa de diálogo Selecionar Dispositivo .

[in] lDeviceType

Tipo: LONG

Especifica qual tipo de dispositivo WIA usar. Pode ser definido como StiDeviceTypeDefault, StiDeviceTypeScanner ou StiDeviceTypeDigitalCamera.

[in] lFlags

Tipo: LONG

Especifica o comportamento da caixa de diálogo. Pode ser definido como qualquer um dos seguintes valores:

Constante	Significado
0	Use o comportamento padrão.
WIA_SELECT_DEVICE_NODEFAULT	Exiba a caixa de diálogo mesmo que haja apenas um dispositivo correspondente. Para obter mais informações, consulte a seção Comentários desta página de referência.

[in, out] pbstrDeviceID

Tipo: BSTR*

Na saída, recebe uma cadeia de caracteres que contém a cadeia de caracteres do identificador do dispositivo. Na entrada, passe o endereço de um ponteiro se essas informações forem necessárias ou NULL se elas não forem necessárias.

[out, retval] ppItemRoot

Tipo: IWiaItem**

Recebe o endereço de um ponteiro para a interface IWiaItem do item raiz da árvore que representa o dispositivo WIA selecionado. Se nenhum dispositivo for encontrado, ele conterá o valor NULL.

Valor retornado

Tipo: HRESULT

Esse método retorna os seguintes valores:

Valor Retornado	Significado
S_OK	Um dispositivo foi selecionado com êxito.
S_FALSE	O usuário cancelou a caixa de diálogo.
WIA_S_NO_DEVICE_AVAILABLE	Não há dispositivos de hardware WIA que correspondam às especificações fornecidas no parâmetro lDeviceType .

Comentários

Esse método cria e exibe a caixa de diálogo Selecionar Dispositivo para que o usuário possa selecionar um dispositivo WIA para aquisição de imagem. Se um dispositivo for selecionado com êxito, o método IWiaDevMgr::SelectDeviceDlg criará uma árvore hierárquica de objetos IWiaItem para o dispositivo. Ele armazena um ponteiro para a interface IWiaItem do item raiz no parâmetro ppItemRoot.

Tipos específicos de dispositivos podem ser exibidos para o usuário especificando os tipos de dispositivo por meio do parâmetro lDeviceType . Se apenas um dispositivo atender à especificação, IWiaDevMgr::SelectDeviceDlg não exibirá a caixa de diálogo Selecionar Dispositivo . Em vez disso, ele cria a árvore IWiaItem para o dispositivo e armazena um ponteiro para a interface IWiaItem do item raiz no parâmetro ppItemRoot. Você pode substituir esse comportamento e forçar IWiaDevMgr::SelectDeviceDlg a exibir a caixa de diálogo Selecionar Dispositivo passando WIA_SELECT_DEVICE_NODEFAULT como o valor do parâmetro lFlags .

Se mais de um dispositivo WIA corresponder à especificação, todos os dispositivos correspondentes serão exibidos na caixa de diálogo Selecionar Dispositivo para que o usuário possa escolher um.

Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppItemRoot .

É recomendável que os aplicativos disponibilizem a seleção de dispositivo e imagem por meio de um item de menu chamado De scanner ou câmera no menu Arquivo .

Requisitos

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)
Biblioteca	Wiaguid.lib
DLL	Wiaservc.dll