IWiaDevMgr2::SelectDeviceDlgID (método)
Muestra un cuadro de diálogo que permite al usuario seleccionar un dispositivo de hardware para la adquisición de imágenes.
Sintaxis
HRESULT SelectDeviceDlgID(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[out, retval] BSTR *pbstrDeviceID
);
Parámetros
-
hwndParent [in]
-
Tipo: HWND
Especifica la ventana primaria del cuadro de diálogo Seleccionar dispositivo .
-
lDeviceType [in]
-
Tipo: LONG
Especifica el tipo de dispositivo WIA 2.0 que se va a usar. Consulte Especificadores de tipo de dispositivo WIA para obtener una lista de los valores posibles.
-
lFlags [in]
-
Tipo: LONG
Especifica el comportamiento del cuadro de diálogo. El valor puede ser uno de los siguientes.
-
0
-
Usa el comportamiento predeterminado.
-
WIA_SELECT_DEVICE_NODEFAULT
-
Muestre el cuadro de diálogo aunque solo haya un dispositivo coincidente.
pbstrDeviceID [out, retval]
Tipo: BSTR*
Puntero a una cadena que recibe la cadena de identificador del dispositivo.
Valor devuelto
Tipo: HRESULT
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El dispositivo se seleccionó correctamente. |
|
El usuario canceló el cuadro de diálogo. |
|
Ningún dispositivo de hardware WIA 2.0 coincide con las especificaciones especificadas en el parámetro lDeviceType . |
Comentarios
Este método crea y muestra el cuadro de diálogo Seleccionar dispositivo para que el usuario pueda seleccionar un dispositivo WIA 2.0 para la adquisición de imágenes. Si un dispositivo se selecciona correctamente, el método IWiaDevMgr2::SelectDeviceDlgID pasa su cadena de identificador a la aplicación a través de su parámetro pbstrDeviceID .
La aplicación puede restringir los dispositivos que se muestran al usuario a tipos concretos especificando los tipos de dispositivo a través del parámetro lDeviceType . Si solo un dispositivo cumple la especificación, IWiaDevMgr2::SelectDeviceDlgID no muestra el cuadro de diálogo Seleccionar dispositivo . En su lugar, pasa la cadena de identificador del dispositivo a la aplicación sin mostrar el cuadro de diálogo. Puede invalidar este comportamiento y forzar IWiaDevMgr2::SelectDeviceDlgID para mostrar el cuadro de diálogo pasando WIA_SELECT_DEVICE_NODEFAULT como valor para el parámetro lFlags . Si más de un dispositivo WIA 2.0 coincide con la especificación, todos los dispositivos coincidentes se muestran en el cuadro de diálogo SeleccionarDispositivo para que el usuario pueda elegir uno.
Nota
Se recomienda que las aplicaciones hagan que la selección de dispositivos e imágenes esté disponible a través de un elemento de menú denominado Desde escáner en el menú Archivo .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| IDL |
|