DEVICEDIALOGDATA2-Struktur (wiadevd.h)

Artikel
02/29/2024

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;

Member

cbSize

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

pIWiaItemRoot

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

dwFlags

Gibt die Flags an, die vom aufrufenden Programm an IWiaItem2::D eviceDlg und IWiaDevMgr2::GetImageDlg ü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 von bstrFolderName angegebenen Zielordner übertragen werden. Durch Anfügen zusätzlicher Zeichen an die Dateinamenvorlage kann eine beliebige Anzahl eindeutiger Dateinamen erstellt werden. Weitere Informationen zu Dateinamenvorlagen finden Sie unter PathMakeUniqueName und PathYetAnotherMakeUniqueName.

lNumFiles

Die Anzahl der Zeichenfolgen, die in das Array pbstrFilePaths geschrieben werden.

pbstrFilePaths

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. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise" .

pWiaItem

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

Hinweise

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

Die DeviceDialog-Methode muss das in pbstrFilePaths angegebene BSTR-Zeigerarray durch Aufrufen der CoTaskMemAlloc-Funktion zuordnen, und sie muss jede Zeichenfolge zuordnen, auf die das Array verweist, indem die SysAllocString-Funktion aufgerufen wird. Das aufrufende Programm ist dafür verantwortlich, den Speicher für das Zeigerarray und die Zeichenfolgen frei zu geben.

Um einen Verweis auf eine IWiaItem2-Schnittstelle beizubehalten, muss die DeviceDialog-Methode die IUnknown::AddRef-Methode für die 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 die IWiaPropertyStorage-Schnittstelle abzurufen. Um Daten von einem IWiaItem2-Objekt zu übertragen, muss die DeviceDialog-Methode das Objekt abfragen, um seine IWiaTransfer-Schnittstelle abzurufen.