Freigeben über


DEVICEDIALOGDATA-Struktur (wiadevd.h)

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

Syntax

typedef struct tagDEVICEDIALOGDATA {
  DWORD    cbSize;
  HWND     hwndParent;
  IWiaItem *pIWiaItemRoot;
  DWORD    dwFlags;
  LONG     lIntent;
  LONG     lItemCount;
  IWiaItem **ppWiaItems;
} DEVICEDIALOGDATA, *LPDEVICEDIALOGDATA, *PDEVICEDIALOGDATA;

Angehörige

cbSize

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

hwndParent

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

pIWiaItemRoot

Verweist auf eine IWiaItem- Schnittstelle, die das gültige Stammelement in der Anwendungselementstruktur darstellt. Weitere Informationen zu dieser Schnittstelle finden Sie in der Windows SDK-Dokumentation.

dwFlags

Gibt die flags an, die an IWiaItem::D eviceDlg und IWiaDevMgr::GetImageDlg durch das aufrufende Programm übergeben werden. Diese Methoden werden in der Windows SDK-Dokumentation beschrieben. Die möglichen Werte für dieses Element sind WIA_DEVICE_DIALOG_SINGLE_IMAGE und WIA_DEVICE_DIALOG_USE_COMMON_UI (definiert in Wiadef.h).

lIntent

Gibt die Absichten an, die an IWiaItem::D eviceDlg und IWiaDevMgr::GetImageDlg durch das aufrufende Programm übergeben werden (siehe Windows SDK-Dokumentation).

lItemCount

Gibt die Anzahl der Elemente im Array an, auf die ppIWiaItems Punkte zurückgibt.

ppWiaItems

Array von IWiaItem-Schnittstellenzeigern. Array muss

Bemerkungen

Die DEVICEDIALOGDATA-Struktur wird von der IWiaUIExtension::D eviceDialog-Methode verwendet.

Das in ppIWiaItems angegebene Array muss mithilfe CoTaskMemAlloc-zugeordnet werden. Alle im Array angegebenen Schnittstellenzeiger müssen mithilfe der AddRef- COM-Methode initialisiert werden. Beschreibungen dieser Funktionen finden Sie in der Windows SDK-Dokumentation.

Die IWiaPropertyStorage Schnittstelle wird verwendet, um auf Informationen über die Eigenschaften des IWiaItem Objekts zuzugreifen. Anwendungen müssen ein Element abfragen, um seine IWiaPropertyStorage Schnittstelle abzurufen. Beschreibungen dieser Schnittstelle finden Sie in der Windows SDK-Dokumentation.

Anforderungen

Anforderung Wert
Header- wiadevd.h (include Wiadevd.h)

Siehe auch

IWiaUIExtension::D eviceDialog