structure DEVICEDIALOGDATA2 (wiadevd.h)

Article
02/07/2025

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

Syntaxe

typedef struct tagDEVICEDIALOGDATA2 {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *pWiaItem;
} DEVICEDIALOGDATA2, *LPDEVICEDIALOGDATA2, *PDEVICEDIALOGDATA2;

Membres

cbSize

Spécifie la taille, en octets, de cette structure.

pIWiaItemRoot

Pointe vers une interface IWiaItem2 qui représente l’élément racine valide dans l’arborescence d’éléments d’application.

dwFlags

Spécifie les indicateurs passés à IWiaItem2 ::D eviceDlg et IWiaDevMgr2 ::GetImageDlg par le programme appelant. Les valeurs possibles pour ce membre sont WIA_DEVICE_DIALOG_SINGLE_IMAGE et WIA_DEVICE_DIALOG_USE_COMMON_UI (définies dans le fichier d’en-tête Wiadef.h).

hwndParent

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

bstrFolderName

Chaîne de type BSTR qui contient le nom du dossier de destination vers lequel les fichiers obtenus à partir d’éléments WIA sont transférés.

bstrFilename

Chaîne de type BSTR qui contient le modèle de nom de fichier à utiliser pour les fichiers transférés d’éléments WIA vers le dossier de destination désigné par bstrFolderName. Un nombre arbitraire de noms de fichiers uniques peut être créé en ajoutant des caractères supplémentaires au modèle de nom de fichier. Pour plus d’informations sur les modèles de nom de fichier, consultez PathMakeUniqueName et PathYetAnotherMakeUniqueName.

lNumFiles

Nombre de chaînes écrites dans le tableau pbstrFilePaths.

pbstrFilePaths

Pointeur vers un tableau de pointeurs BSTR. Chaque élément de tableau pointe vers un BSTR qui contient le nom de destination d’un fichier qui a été transféré avec succès vers le dossier identifié par bstrFolderName. La méthode doit allouer le stockage pour ce membre. Pour plus d’informations, consultez la section suivante Remarques.

pWiaItem

Pointeur vers l’interface IWiaItem2 de l’élément WIA qui transfère les données au fichier ou aux fichiers nommés dans le tableau bstrFilePaths.

Remarques

La structure DEVICEDIALOGDATA2 est utilisée par la méthode IWiaUIExtension2 ::D eviceDialog.

La méthode DeviceDialog doit allouer le tableau de pointeurs BSTR spécifié dans pbstrFilePaths en appelant la fonction CoTaskMemAlloc, et il doit allouer chaque chaîne pointée par le tableau en appelant la fonction SysAllocString. Le programme appelant est chargé de libérer le stockage pour le tableau de pointeurs et les chaînes.

Pour conserver une référence à une interface IWiaItem2, la méthode DeviceDialog doit appeler la méthode IUnknown ::AddRef sur l’interface avant de revenir de l’appel.

Pour accéder aux informations relatives aux propriétés d’un objet IWiaItem2, la méthode DeviceDialog doit interroger l’objet pour obtenir son interface IWiaPropertyStorage. Pour transférer des données à partir d’un objet IWiaItem2, la méthode DeviceDialog doit interroger l’objet pour obtenir son interface IWiaTransfer.