Struttura DEVICEDIALOGDATA2

Definisce i dati necessari per chiamare una finestra di dialogo del dispositivo.

Sintassi

typedef struct {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *ppWiaItem;
} DEVICEDIALOGDATA2;

Members

cbSize

Tipo: DWORD

Specifica le dimensioni di questa struttura in byte.

pIWiaItemRoot

Tipo: IWiaItem2*

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

dwFlags

Tipo: DWORD

Specifica un set di flag che controllano l'operazione della finestra di dialogo. Può essere impostato su uno dei valori seguenti:

Flag	Significato
0	Comportamento predefinito.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Limitare la selezione delle immagini a una singola immagine nella finestra di dialogo acquisizione immagini del dispositivo.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Usare l'interfaccia utente di sistema, se disponibile, anziché l'interfaccia utente fornita dal fornitore. Se l'interfaccia utente del sistema non è disponibile, viene usata l'interfaccia utente del fornitore. Se nessuna dell'interfaccia utente è disponibile, la funzione restituisce E_NOTIMPL.

 

hwndParent

Tipo: HWND

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

bstrFolderName

Tipo: BSTR

Specifica il nome della cartella in cui vengono trasferiti i file.

Bstrfilename

Tipo: BSTR

Specifica il modello di nome file da usare per i file trasferiti da 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.

lNumFiles

Tipo: LONG

Riceve il numero di stringhe scritte nella matrice pbstrFilePaths .

pbstrFilePaths

Tipo: BSTR*

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.

ppWiaItem

Tipo: IWiaItem2*

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

Requisiti