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;
Member
cbSize
Gibt die Größe dieser Struktur in Bytes an.
hwndParent
Gibt das Handle für das übergeordnete Fenster des Dialogfelds an.
pIWiaItemRoot
Zeigt 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 vom aufrufenden Programm an IWiaItem::D eviceDlg und IWiaDevMgr::GetImageDlg übergeben werden. Diese Methoden werden in der Dokumentation zum Windows SDK beschrieben. Die möglichen Werte für diesen Member sind WIA_DEVICE_DIALOG_SINGLE_IMAGE und WIA_DEVICE_DIALOG_USE_COMMON_UI (definiert in Wiadef.h).
lIntent
Gibt die Absichten an, die vom aufrufenden Programm an IWiaItem::D eviceDlg und IWiaDevMgr::GetImageDlg übergeben werden (siehe Windows SDK-Dokumentation).
lItemCount
Gibt die Anzahl der Elemente im Array an, auf die ppIWiaItems verweist.
ppWiaItems
Array von IWiaItem-Schnittstellenzeigern. Array muss
Hinweise
Die DEVICEDIALOGDATA-Struktur wird von der IWiaUIExtension::D eviceDialog-Methode verwendet.
Das in ppIWiaItems angegebene Array muss mithilfe von CoTaskMemAlloc zugeordnet werden. Alle im Array angegebenen Schnittstellenzeiger müssen mit 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 die IWiaPropertyStorage-Schnittstelle abzurufen. Beschreibungen dieser Schnittstelle finden Sie in der Windows SDK-Dokumentation.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wiadevd.h (include Wiadevd.h) |