Método IWiaItem2::D eviceDlg

Muestra un cuadro de diálogo al usuario para prepararse para la adquisición de imágenes.

Sintaxis

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

Parámetros

lFlags [in]

Tipo: LONG

Especifica un conjunto de marcas que controlan la operación del cuadro de diálogo. El valor puede ser 0 para representar el comportamiento predeterminado o cualquiera de las marcas de WIA_DEVICE_DIALOG descritas en WiaFlag.

hwndParent [in]

Tipo: HWND

Identificador de la ventana primaria.

bstrFolderName [in]

Tipo: BSTR

Especifica el nombre de carpeta donde se van a transferir los archivos.

bstrFilename [in]

Tipo: BSTR

Especifica el nombre del archivo de plantilla.

plNumFiles [in]

Tipo: LONG*

Puntero al número de elementos de la matriz ppbstrFilePaths .

ppbstrFilePaths [in, out]

Tipo: BSTR**

Dirección de un puntero a una matriz de rutas de acceso para los archivos examinados. Inicialice el puntero para que apunte a una matriz de tamaño cero (0) antes de llamar a IWiaItem2::D eviceDlg .

ppIWiaItem2 [in, out]

Tipo: IWiaItem2**

Dirección de una matriz de punteros a interfaces IWiaItem2 .

Valor devuelto

Tipo: HRESULT

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

Comentarios

Este método muestra un cuadro de diálogo al usuario que usa una aplicación para recopilar toda la información necesaria para la adquisición de imágenes. 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 IWiaTransfer 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 ppIWiaItem2 . Las aplicaciones también deben liberar la matriz mediante CoTaskMemFree.

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