DEVICEDIALOGDATA2 struttura (wiadevd.h)

Articolo
02/29/2024

La struttura DEVICEDIALOGDATA2 contiene tutti i dati necessari per implementare una finestra di dialogo del dispositivo personalizzata.

Sintassi

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

Members

cbSize

Specifica le dimensioni, in byte, di questa struttura.

pIWiaItemRoot

Punta a un'interfaccia IWiaItem2 che rappresenta l'elemento radice valido nell'albero degli elementi dell'applicazione.

dwFlags

Specifica i flag passati a IWiaItem2::D eviceDlg e IWiaDevMgr2::GetImageDlg dal programma chiamante. I valori possibili per questo membro sono WIA_DEVICE_DIALOG_SINGLE_IMAGE e WIA_DEVICE_DIALOG_USE_COMMON_UI (definiti nel file di intestazione Wiadef.h).

hwndParent

Specifica l'handle nella finestra padre della finestra di dialogo.

bstrFolderName

Stringa di tipo BSTR contenente il nome della cartella di destinazione a cui vengono trasferiti i file ottenuti dagli elementi WIA.

bstrFilename

Stringa di tipo BSTR contenente il modello di nome file da usare per i file trasferiti dagli elementi WIA alla cartella di destinazione designata da bstrFolderName. È possibile creare un numero arbitrario di nomi di file univoci aggiungendo caratteri aggiuntivi al modello di nome file. Per altre informazioni sui modelli di nome file, vedere PathMakeUniqueName e PathYetAnotherMakeUniqueName.

lNumFiles

Numero di stringhe scritte nella matrice pbstrFilePaths .

pbstrFilePaths

Puntatore a una matrice di puntatori BSTR . Ogni elemento matrice punta a un BSTR contenente il nome di destinazione di un file trasferito correttamente alla cartella identificata da bstrFolderName. Il metodo deve allocare l'archiviazione per questo membro. Per altre informazioni, vedere la sezione Osservazioni seguenti.

pWiaItem

Puntatore all'interfaccia IWiaItem2 dell'elemento WIA che trasferisce i dati al file o ai file denominati nella matrice bstrFilePaths .

Commenti

La struttura DEVICEDIALOGDATA2 viene usata dal metodo IWiaUIExtension2::D eviceDialog .

Il metodo DeviceDialog deve allocare la matrice di puntatore BSTR specificata in pbstrFilePath chiamando la funzione CoTaskMemAlloc e deve allocare ogni stringa puntata dalla matrice chiamando la funzione SysAllocString. Il programma chiamante è responsabile della liberazione dell'archiviazione per la matrice e le stringhe del puntatore.

Per conservare un riferimento a un'interfaccia IWiaItem2 , il metodo DeviceDialog deve chiamare il metodo IUnknown::AddRef nell'interfaccia prima di restituire dalla chiamata.

Per accedere alle informazioni sulle proprietà di un oggetto IWiaItem2 , il metodo DeviceDialog deve eseguire query sull'oggetto per ottenere l'interfaccia IWiaPropertyStorage . Per trasferire i dati da un oggetto IWiaItem2 , il metodo DeviceDialog deve eseguire query sull'oggetto per ottenere l'interfaccia IWiaTransfer .