Método IWiaDevMgr2::SelectDeviceDlgID
Exibe uma caixa de diálogo que permite que o usuário selecione 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
-
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 [out, retval]
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 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::SelectDeviceDlgID passará sua cadeia de caracteres de identificador para o aplicativo por meio de seu parâmetro pbstrDeviceID .
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::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 IWiaDevMgr2::SelectDeviceDlgID a exibir a caixa de diálogo passando 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 SelectDevice para que o usuário possa escolher um.
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 |
|