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

O método IWiaDevMgr::SelectDeviceDlgID exibe uma caixa de diálogo que permite ao usuário selecionar um dispositivo de hardware para aquisição de imagem.

Sintaxe

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

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.

[out, retval] pbstrDeviceID

Tipo: BSTR*

Ponteiro para uma cadeia de caracteres que recebe a cadeia de caracteres do identificador do dispositivo.

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 anexados ao computador do usuário que correspondam às especificações.

Comentários

Esse método funciona de maneira semelhante a IWiaDevMgr::SelectDeviceDlg. A principal diferença é que, se encontrar um dispositivo correspondente, ele não criará a árvore hierárquica de objetos IWiaItem para o dispositivo.

Assim como IWiaDevMgr::SelectDeviceDlg, o método IWiaDevMgr::SelectDeviceDlgID cria e exibe a caixa de diálogo Selecionar Dispositivo . Isso permite que o usuário selecione um dispositivo WIA para aquisição de imagem. Se um dispositivo for selecionado com êxito, o método IWiaDevMgr::SelectDeviceDlgID passará sua cadeia de caracteres de identificador para o aplicativo por meio do parâmetro pbstrDeviceID .

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::SelectDeviceDlgID não exibirá a caixa de diálogo Selecionar Dispositivo . Em vez disso, ele passa a cadeia de caracteres do identificador do dispositivo para o aplicativo sem exibir a caixa de diálogo. Você pode substituir esse comportamento e forçar IWiaDevMgr::SelectDeviceDlgID para 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.

É 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