estructura DEVICEDIALOGDATA2 (wiadevd.h)

Artículo
08/08/2023

La estructura DEVICEDIALOGDATA2 contiene todos los datos necesarios para implementar un cuadro de diálogo de dispositivo personalizado.

Sintaxis

typedef struct tagDEVICEDIALOGDATA2 {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *pWiaItem;
} DEVICEDIALOGDATA2, *LPDEVICEDIALOGDATA2, *PDEVICEDIALOGDATA2;

Miembros

cbSize

Especifica el tamaño, en bytes, de esta estructura.

pIWiaItemRoot

Apunta a una interfaz IWiaItem2 que representa el elemento raíz válido en el árbol de elementos de aplicación.

dwFlags

Especifica las marcas pasadas a IWiaItem2::D eviceDlg e IWiaDevMgr2::GetImageDlg mediante el programa de llamada. Los valores posibles para este miembro son WIA_DEVICE_DIALOG_SINGLE_IMAGE y WIA_DEVICE_DIALOG_USE_COMMON_UI (definidos en el archivo de encabezado Wiadef.h).

hwndParent

Especifica el identificador de la ventana primaria del cuadro de diálogo.

bstrFolderName

Cadena de tipo BSTR que contiene el nombre de la carpeta de destino a la que se transfieren los archivos obtenidos de los elementos WIA.

bstrFilename

Cadena de tipo BSTR que contiene la plantilla de nombre de archivo que se va a usar para los archivos transferidos desde elementos WIA a la carpeta de destino designada por bstrFolderName. Se puede crear un número arbitrario de nombres de archivo únicos anexando caracteres adicionales a la plantilla de nombre de archivo. Para obtener más información sobre las plantillas de nombre de archivo, vea PathMakeUniqueName y PathYetAnotherMakeUniqueName.

lNumFiles

Número de cadenas escritas en la matriz pbstrFilePaths .

pbstrFilePaths

Puntero a una matriz de punteros BSTR . Cada elemento de matriz apunta a un BSTR que contiene el nombre de destino de un archivo que se transfirió correctamente a la carpeta identificada por bstrFolderName. El método debe asignar el almacenamiento para este miembro. Para obtener más información, vea la siguiente sección Comentarios .

pWiaItem

Puntero a la interfaz IWiaItem2 del elemento WIA que transfiere datos al archivo o archivos denominados en la matriz bstrFilePaths .

Comentarios

La estructura DEVICEDIALOGDATA2 la usa el método IWiaUIExtension2::D eviceDialog .

El método DeviceDialog debe asignar la matriz de punteroS BSTR especificada en pbstrFilePaths llamando a la función CoTaskMemAlloc y debe asignar cada cadena a la que apunta la matriz llamando a la función SysAllocString . El programa de llamada es responsable de liberar el almacenamiento de la matriz de punteros y las cadenas.

Para conservar una referencia a una interfaz IWiaItem2 , el método DeviceDialog debe llamar al método IUnknown::AddRef en la interfaz antes de volver desde la llamada.

Para obtener acceso a información sobre las propiedades de un objeto IWiaItem2 , el método DeviceDialog debe consultar el objeto para obtener su interfaz IWiaPropertyStorage . Para transferir datos desde un objeto IWiaItem2 , el método DeviceDialog debe consultar el objeto para obtener su interfaz IWiaTransfer .