Compartir a través de

Método IWiaItem::D eviceDlg (wia_xp.h)

  • Artículo

Las aplicaciones usan el método IWiaItem::D eviceDlg para mostrar un cuadro de diálogo al usuario para prepararse para la adquisición de imágenes.

Sintaxis

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

Parámetros

[in] hwndParent

Tipo: HWND

Identificador de la ventana primaria del cuadro de diálogo.

[in] lFlags

Tipo: LONG

Especifica un conjunto de marcas que controlan la operación del cuadro de diálogo. Se puede establecer en cualquiera de los valores siguientes:

Marca Significado
0 Comportamiento predeterminado.
WIA_DEVICE_DIALOG_SINGLE_IMAGE Restrinja la selección de imágenes a una sola imagen en el cuadro de diálogo de adquisición de imágenes de dispositivo.
WIA_DEVICE_DIALOG_USE_COMMON_UI Use la interfaz de usuario del sistema, si está disponible, en lugar de la interfaz de usuario proporcionada por el proveedor. Si la interfaz de usuario del sistema no está disponible, se usa la interfaz de usuario del proveedor. Si ninguna interfaz de usuario está disponible, la función devuelve E_NOTIMPL.

[in] lIntent

Tipo: LONG

Especifica qué tipo de datos se va a representar la imagen. Para obtener una lista de valores de intención de imagen, consulte Constantes de intención de imagen.

Nota Este método omite todas las intenciones de imagen WIA_INTENT_IMAGE_*.
 

[out] plItemCount

Tipo: LONG*

Recibe el número de elementos de la matriz indicado por el parámetro ppIWiaItem .

[out] ppIWiaItem

Tipo: IWiaItem***

Recibe la dirección de una matriz de punteros a interfaces IWiaItem .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método muestra un cuadro de diálogo al usuario que una aplicación usa para recopilar toda la información necesaria para la adquisición de imágenes. Por ejemplo, este cuadro de diálogo permite al usuario seleccionar imágenes para descargar desde una cámara. Cuando se usa un escáner, también se usa para especificar propiedades de examen de imágenes como brillo y contraste.

Una vez devuelto este método, la aplicación puede usar la interfaz IWiaDataTransfer para adquirir la imagen.

Las aplicaciones deben llamar al método IUnknown::Release para cada elemento de la matriz de punteros de interfaz que reciben a través del parámetro ppIWiaItem . Las aplicaciones también deben liberar la matriz mediante CoTaskMemFree.

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

Requisito Value
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