DEVICEDIALOGDATA structure

Defines the data needed to call a device dialog.

Syntax

typedef struct {
  DWORD    cbSize;
  HWND     hwndParent;
  IWiaItem *pIWiaItemRoot;
  DWORD    dwFlags;
  LONG     lIntent;
  LONG     lItemCount;
  IWiaItem **ppWiaItem;
} DEVICEDIALOGDATA;

Members

cbSize

Type: DWORD

Specifies the size of this structure in bytes.

hwndParent

Type: HWND

Specifies the handle to the parent window of the dialog.

pIWiaItemRoot

Type: IWiaItem*

Points to an IWiaItem interface that represents the valid root item in the application item tree.

dwFlags

Type: DWORD

Specifies a set of flags that control the dialog box's operation. Can be set to any of the following values:

Flag	Meaning
0	Default behavior.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Restrict image selection to a single image in the device image acquisition dialog box.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Use the system UI, if available, rather than the vendor-supplied UI. If the system UI is not available, the vendor UI is used. If neither UI is available, the function returns E_NOTIMPL.

 

lIntent

Type: LONG

Specifies what type of data the image is intended to represent. For a list of image intent values, see Image Intent Constants.

lItemCount

Type: LONG

Receives the number of items in the array indicated by the ppWiaItem parameter.

ppWiaItem

Type: IWiaItem**

Receives the address of an array of pointers to IWiaItem interfaces.

Requirements