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

El método IWiaDevMgr::SelectDeviceDlgID 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

[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	Muestre el cuadro de diálogo aunque solo haya un dispositivo coincidente. Para obtener más información, vea la sección Comentarios de esta página de referencia.

[out, retval] pbstrDeviceID

Tipo: BSTR*

Puntero a una cadena que recibe la cadena de identificador del dispositivo.

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 conectados al equipo del usuario que coincidan con las especificaciones.

Comentarios

Este método funciona de forma similar a IWiaDevMgr::SelectDeviceDlg. La principal diferencia es que si encuentra un dispositivo coincidente, no crea el árbol jerárquico de objetos IWiaItem para el dispositivo.

Al igual que IWiaDevMgr::SelectDeviceDlg, el método IWiaDevMgr::SelectDeviceDlgID crea y muestra el cuadro de diálogo Seleccionar dispositivo . Esto permite al usuario seleccionar un dispositivo WIA para la adquisición de imágenes. Si un dispositivo se selecciona correctamente, el método IWiaDevMgr::SelectDeviceDlgID pasa su cadena de identificador a la aplicación a través de su parámetro pbstrDeviceID .

Los tipos concretos de dispositivos se pueden mostrar al usuario especificando los tipos de dispositivo a través del parámetro lDeviceType . Si solo un dispositivo cumple la especificación, IWiaDevMgr::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 que IWiaDevMgr::SelectDeviceDlgID muestre el cuadro de diálogo Seleccionar dispositivo pasando WIA_SELECT_DEVICE_NODEFAULT como valor para el 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.

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 (incluya Wia.h)
Library	Wiaguid.lib
Archivo DLL	Wiaservc.dll