DEVICEDIALOGDATA2-Struktur

Definiert die Daten, die zum Aufrufen eines Gerätedialogfelds erforderlich sind.

Syntax

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

Member

cbSize

Art: DWORD

Gibt die Größe dieser Struktur in Bytes an.

pIWiaItemRoot

Typ: IWiaItem2*

Zeigt auf eine IWiaItem2-Schnittstelle , die das gültige Stammelement in der Anwendungselementstruktur darstellt.

dwFlags

Art: DWORD

Gibt eine Reihe von Flags an, die den Vorgang des Dialogfelds steuern. Kann auf einen der folgenden Werte festgelegt werden:

Flag	Bedeutung
0	Standardverhalten.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Beschränken Sie die Bildauswahl auf ein einzelnes Bild im Dialogfeld Gerätebilderfassung.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Verwenden Sie die Systembenutzeroberfläche, falls verfügbar, anstelle der vom Anbieter bereitgestellten Benutzeroberfläche. Wenn die System-Benutzeroberfläche nicht verfügbar ist, wird die Anbieter-UI verwendet. Wenn keine benutzeroberfläche verfügbar ist, gibt die Funktion E_NOTIMPL zurück.

 

hwndParent

Typ: HWND

Gibt das Handle für das übergeordnete Fenster des Dialogfelds an.

bstrFolderName

Typ: BSTR

Gibt den Ordnernamen an, in den die Dateien übertragen werden.

bstrFilename

Typ: BSTR

Gibt die Dateinamenvorlage an, die für Dateien verwendet werden soll, die von WIA-Elementen in den von bstrFolderName angegebenen Zielordner übertragen werden. Durch Anfügen zusätzlicher Zeichen an die Dateinamenvorlage kann eine beliebige Anzahl eindeutiger Dateinamen erstellt werden.

lNumFiles

Typ: LONG

Empfängt die Anzahl der Zeichenfolgen, die in das Array pbstrFilePaths geschrieben wurden.

pbstrFilePaths

Typ: BSTR*

Zeiger auf ein Array von BSTR-Zeigern. Jedes Arrayelement verweist auf einen BSTR, der den Zielnamen einer Datei enthält, die erfolgreich in den durch bstrFolderName identifizierten Ordner übertragen wurde. Die -Methode muss den Speicher für dieses Member zuordnen.

ppWiaItem

Typ: IWiaItem2*

Zeiger auf die IWiaItem2-Schnittstelle des WIA-Elements, das Daten an die Datei oder dateien im Array pbstrFilePaths überträgt.

Anforderungen