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
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::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	Wia.h
IDL	Wia.idl