Structure DEVICEDIALOGDATA (wiadevd.h)

La structure DEVICEDIALOGDATA contient toutes les données nécessaires pour implémenter une boîte de dialogue d’appareil personnalisée.

Syntaxe

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

Membres

cbSize

Spécifie la taille de cette structure en octets.

hwndParent

Spécifie le handle de la fenêtre parente de la boîte de dialogue.

pIWiaItemRoot

Pointe vers une interface IWiaItem qui représente l’élément racine valide dans l’arborescence d’éléments d’application. Pour plus d’informations sur cette interface, consultez la documentation du Kit de développement logiciel (SDK) Windows.

dwFlags

Spécifie les indicateurs passés à IWiaItem ::D eviceDlg et IWiaDevMgr ::GetImageDlg par le programme appelant. Ces méthodes sont décrites dans la documentation du Kit de développement logiciel (SDK) Windows. Les valeurs possibles pour ce membre sont WIA_DEVICE_DIALOG_SINGLE_IMAGE et WIA_DEVICE_DIALOG_USE_COMMON_UI (définies dans Wiadef.h).

lIntent

Spécifie les intentions passées à IWiaItem ::D eviceDlg et IWiaDevMgr ::GetImageDlg par le programme appelant (voir la documentation du KIT de développement logiciel Windows).

lItemCount

Spécifie le nombre d’éléments du tableau vers lesquels ppIWiaItems pointe.

ppWiaItems

Tableau de pointeurs d’interface IWiaItem. Le tableau doit

Remarques

La structure DEVICEDIALOGDATA est utilisée par la méthode IWiaUIExtension ::D eviceDialog .

Le tableau spécifié dans ppIWiaItems doit être alloué à l’aide de CoTaskMemAlloc. Tous les pointeurs d’interface indiqués dans le tableau doivent être initialisés à l’aide de la méthode COM AddRef . Consultez la documentation du Kit de développement logiciel (SDK) Windows pour obtenir des descriptions de ces fonctions.

L’interface IWiaPropertyStorage est utilisée pour accéder aux informations sur les propriétés de l’objet IWiaItem. Les applications doivent interroger un élément pour obtenir son interface IWiaPropertyStorage . Pour obtenir des descriptions de cette interface, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Configuration requise

Voir aussi

IWiaUIExtension ::D eviceDialog