Compartir a través de

Método IWiaDevMgr::SelectDeviceDlg (wia_xp.h)

  • Artículo

IWiaDevMgr::SelectDeviceDlg 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] IWiaItem **ppItemRoot
);

Parámetros

[in] hwndParent

Tipo: HWND

Identificador de la ventana que posee el cuadro de diálogo Seleccionar dispositivo .

[in] lDeviceType

Tipo: LONG

Especifica el tipo de dispositivo WIA que se va a usar. Se puede establecer en StiDeviceTypeDefault, StiDeviceTypeScanner o StiDeviceTypeDigitalCamera.

[in] lFlags

Tipo: LONG

Especifica el comportamiento del cuadro de diálogo. Se puede establecer en cualquiera de los valores siguientes:

Constante Significado
0 Usa el comportamiento predeterminado.
WIA_SELECT_DEVICE_NODEFAULT Muestra el cuadro de diálogo incluso si solo hay un dispositivo coincidente. Para obtener más información, vea la sección Comentarios de esta página de referencia.

[in, out] pbstrDeviceID

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.

[out, retval] ppItemRoot

Tipo: IWiaItem**

Recibe la dirección de un puntero a la interfaz IWiaItem del elemento raíz del árbol que representa el dispositivo WIA seleccionado. Si no se encuentra ningún dispositivo, contiene el valor NULL.

Valor devuelto

Tipo: HRESULT

Este método devuelve los siguientes valores:

Valor devuelto Significado
S_OK Se seleccionó correctamente un dispositivo.
S_FALSE El usuario canceló el cuadro de diálogo.
WIA_S_NO_DEVICE_AVAILABLE No hay dispositivos de hardware WIA que coincidan 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 para la adquisición de imágenes. Si un dispositivo se selecciona correctamente, el método IWiaDevMgr::SelectDeviceDlg crea un árbol jerárquico de objetos IWiaItem para el dispositivo. Almacena un puntero a la interfaz IWiaItem del elemento raíz en el parámetro ppItemRoot.

Los tipos concretos de dispositivos se pueden mostrar al usuario especificando los tipos de dispositivo mediante el parámetro lDeviceType . Si solo un dispositivo cumple la especificación, IWiaDevMgr::SelectDeviceDlg no muestra el cuadro de diálogo Seleccionar dispositivo . En su lugar, crea el árbol IWiaItem para el dispositivo y almacena un puntero a la interfaz IWiaItem del elemento raíz en el parámetro ppItemRoot. Puede invalidar este comportamiento y forzar que IWiaDevMgr::SelectDeviceDlg muestre el cuadro de diálogo Seleccionar dispositivo pasando WIA_SELECT_DEVICE_NODEFAULT como el valor del parámetro lFlags .

Si más de un dispositivo WIA 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 .

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 o cámara en el menú Archivo .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluye Wia.h)
Library Wiaguid.lib
Archivo DLL Wiaservc.dll