Método IWiaDevMgr2::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] IWiaItem2 **ppItemRoot
);
Parâmetros
-
hwndParent [in]
-
Digite: HWND
Especifica a janela pai da caixa de diálogo Selecionar Dispositivo .
-
lDeviceType [in]
-
Tipo: LONG
Especifica qual tipo de dispositivo WIA 2.0 usar. Consulte Especificadores de tipo de dispositivo WIA para obter uma lista de valores possíveis.
-
lFlags [in]
-
Tipo: LONG
Especifica o comportamento da caixa de diálogo. O valor pode ser um dos seguintes.
-
0
-
Use o comportamento padrão.
-
WIA_SELECT_DEVICE_NODEFAULT
-
Exiba a caixa de diálogo mesmo que haja apenas um dispositivo correspondente.
pbstrDeviceID [in, out]
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.
ppItemRoot [out, retval]
Tipo: IWiaItem2**
Recebe o endereço de um ponteiro para a interface IWiaItem2 do item raiz da árvore hierárquica que representa o dispositivo WIA 2.0 selecionado. Se nenhum dispositivo for encontrado, ele receberá NULL.
Valor retornado
Tipo: HRESULT
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O dispositivo foi selecionado com êxito. |
|
O usuário cancelou a caixa de diálogo. |
|
Nenhum dispositivo de hardware WIA 2.0 corresponde à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 2.0 para aquisição de imagem. Se um dispositivo for selecionado com êxito, o método IWiaDevMgr2::SelectDeviceDlg criará uma árvore hierárquica de objetos IWiaItem2 para o dispositivo. Ele armazena um ponteiro para a interface IWiaItem2 do item raiz no parâmetro ppItemRoot.
O aplicativo pode restringir os dispositivos exibidos ao usuário a tipos específicos especificando os tipos de dispositivo por meio do parâmetro lDeviceType . Se apenas um dispositivo atender à especificação, IWiaDevMgr2::SelectDeviceDlg não exibirá a caixa de diálogo Selecionar Dispositivo . Em vez disso, ele cria a árvore IWiaItem2 para o dispositivo e armazena um ponteiro para a interface IWiaItem2 do item raiz no parâmetro ppItemRoot. Você pode substituir esse comportamento e forçar IWiaDevMgr2::SelectDeviceDlg a exibir a caixa de diálogo especificando WIA_SELECT_DEVICE_NODEFAULT como o valor do parâmetro lFlags . Se mais de um dispositivo WIA 2.0 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 .
Observação
É recomendável que os aplicativos disponibilizem a seleção de dispositivo e imagem por meio de um item de menu chamado De scanner no menu Arquivo .
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 |
|