IWiaDevMgr2::SelectDeviceDlg (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 SelectDeviceDlg(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[in, out] BSTR *pbstrDeviceID,
[out, retval] IWiaItem2 **ppItemRoot
);
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 [in, out]
Tipo: BSTR*
En la salida, recibe una cadena que contiene la cadena de identificador del dispositivo. En la entrada, pase la dirección de un puntero si se necesita esta información o NULL si no es necesario.
ppItemRoot [out, retval]
Tipo: IWiaItem2**
Recibe la dirección de un puntero a la interfaz IWiaItem2 del elemento raíz del árbol jerárquico que representa el dispositivo WIA 2.0 seleccionado. Si no se encuentra ningún dispositivo, recibe NULL.
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::SelectDeviceDlg crea un árbol jerárquico de objetos IWiaItem2 para el dispositivo. Almacena un puntero a la interfaz IWiaItem2 del elemento raíz en el parámetro ppItemRoot.
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::SelectDeviceDlg no muestra el cuadro de diálogo Seleccionar dispositivo . En su lugar, crea el árbol IWiaItem2 para el dispositivo y almacena un puntero a la interfaz IWiaItem2 del elemento raíz en el parámetro ppItemRoot. Puede invalidar este comportamiento y forzar que IWiaDevMgr2::SelectDeviceDlg muestre el cuadro de diálogo especificando 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 Seleccionar dispositivo para que el usuario pueda elegir uno.
Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppItemRoot .
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 |
|