DEVICEDIALOGDATA structure (wiadevd.h)
The DEVICEDIALOGDATA structure contains all the data needed to implement a custom device dialog.
Syntax
typedef struct tagDEVICEDIALOGDATA {
DWORD cbSize;
HWND hwndParent;
IWiaItem *pIWiaItemRoot;
DWORD dwFlags;
LONG lIntent;
LONG lItemCount;
IWiaItem **ppWiaItems;
} DEVICEDIALOGDATA, *LPDEVICEDIALOGDATA, *PDEVICEDIALOGDATA;
Members
cbSize
Specifies the size of this structure in bytes.
hwndParent
Specifies the handle to the parent window of the dialog.
pIWiaItemRoot
Points to an IWiaItem interface that represents the valid root item in the application item tree. For more information about this interface, see the Windows SDK documentation.
dwFlags
Specifies the flags passed to IWiaItem::DeviceDlg and IWiaDevMgr::GetImageDlg by the calling program. These methods are described in the Windows SDK documentation. The possible values for this member are WIA_DEVICE_DIALOG_SINGLE_IMAGE and WIA_DEVICE_DIALOG_USE_COMMON_UI (defined in Wiadef.h).
lIntent
Specifies the intents passed to IWiaItem::DeviceDlg and IWiaDevMgr::GetImageDlg by the calling program (see the Windows SDK documentation).
lItemCount
Specifies the number of items in the array to which ppIWiaItems points.
ppWiaItems
Array of IWiaItem interface pointers. Array must
Remarks
The DEVICEDIALOGDATA structure is used by the IWiaUIExtension::DeviceDialog method.
The array specified in ppIWiaItems must be allocated using CoTaskMemAlloc. All interface pointers indicated in the array must be initialized using the AddRef COM method. See the Windows SDK documentation for descriptions of these functions.
The IWiaPropertyStorage interface is used to access information about the IWiaItem object's properties. Applications must query an item to obtain its IWiaPropertyStorage interface. See the Windows SDK documentation for descriptions of this interface.
Requirements
Requirement | Value |
---|---|
Header | wiadevd.h (include Wiadevd.h) |