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
S_OK	El dispositivo se seleccionó correctamente.
S_FALSE	El usuario canceló el cuadro de diálogo.
WIA_S_NO_DEVICE_AVAILABLE	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	Wia.h
IDL	Wia.idl