DEVICEDIALOGDATA2 Struktur (wiadevd.h)

Die DEVICEDIALOGDATA2 Struktur enthält alle Daten, die zum Implementieren eines benutzerdefinierten Gerätedialogfelds erforderlich sind.

Syntax

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

Angehörige

cbSize

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

pIWiaItemRoot

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

dwFlags

Gibt die flags an, die an IWiaItem2::D eviceDlg und IWiaDevMgr2::GetImageDlg durch das aufrufende Programm übergeben werden. Die möglichen Werte für dieses Element sind WIA_DEVICE_DIALOG_SINGLE_IMAGE und WIA_DEVICE_DIALOG_USE_COMMON_UI (definiert in der Headerdatei Wiadef.h).

hwndParent

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

bstrFolderName

Eine Zeichenfolge vom Typ BSTR-, die den Namen des Zielordners enthält, in den die von WIA-Elementen abgerufenen Dateien übertragen werden.

bstrFilename

Eine Zeichenfolge vom Typ BSTR, die die Dateinamenvorlage enthält, die für Dateien verwendet werden soll, die von WIA-Elementen in den Zielordner übertragen werden, der von bstrFolderNamefestgelegt wird. Eine beliebige Anzahl eindeutiger Dateinamen kann durch Anfügen zusätzlicher Zeichen an die Dateinamenvorlage erstellt werden. Weitere Informationen zu Dateinamenvorlagen finden Sie unter PathMakeUniqueName und PathYetAnotherMakeUniqueName.

lNumFiles

Die Anzahl der Zeichenfolgen, die in das pbstrFilePaths Arrays geschrieben wurden.

pbstrFilePaths

Zeiger auf ein Array von BSTR- Zeigern. Jedes Arrayelement verweist auf eine BSTR-, die den Zielnamen einer Datei enthält, die erfolgreich in den durch bstrFolderNameidentifizierten Ordner übertragen wurde. Die Methode muss den Speicher für dieses Element zuordnen. Weitere Informationen finden Sie im folgenden abschnitt Anmerkungen.

pWiaItem

Zeiger auf die IWiaItem2 Schnittstelle des WIA-Elements, das Daten an die Datei oder Dateien überträgt, die im bstrFilePaths Array benannt sind.

Bemerkungen

Die DEVICEDIALOGDATA2 Struktur wird von der IWiaUIExtension2::D eviceDialog-Methode verwendet.

Die DeviceDialog-Methode muss das BSTR- zeigerarray zuweisen, das in pbstrFilePaths angegeben ist, indem die CoTaskMemAlloc--Funktion aufgerufen wird, und sie muss jede Zeichenfolge zuordnen, auf die das Array verweist, indem die SysAllocString--Funktion aufgerufen wird. Das aufrufende Programm ist für das Freigeben des Speichers für das Zeigerarray und die Zeichenfolgen verantwortlich.

Um einen Verweis auf eine IWiaItem2--Schnittstelle beizubehalten, muss die DeviceDialog--Methode die IUnknown::AddRef-Methode auf der Schnittstelle aufrufen, bevor sie vom Aufruf zurückgegeben wird.

Um auf Informationen über die Eigenschaften eines IWiaItem2- Objekts zuzugreifen, muss die DeviceDialog--Methode das Objekt abfragen, um seine IWiaPropertyStorage Schnittstelle abzurufen. Um Daten von einem IWiaItem2--Objekt zu übertragen, muss die DeviceDialog--Methode das Objekt abfragen, um seine IWiaTransfer Schnittstelle abzurufen.

Anforderungen

Siehe auch

CoTaskMemAlloc-

IUnknown::AddRef

IWiaDevMgr2::GetImageDlg

IWiaItem2-

IWiaItem2::D eviceDlg

IWiaPropertyStorage

IWiaTransfer

IWiaUIExtension2::D eviceDialog

PathMakeUniqueName

PathYetAnotherMakeUniqueName Function

SysAllocString-