Structure DEVICEDIALOGDATA2

Définit les données nécessaires pour appeler une boîte de dialogue d’appareil.

Syntaxe

typedef struct {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *ppWiaItem;
} DEVICEDIALOGDATA2;

Membres

cbSize

Type : DWORD

Spécifie la taille de cette structure en octets.

pIWiaItemRoot

Type : IWiaItem2*

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

dwFlags

Type : DWORD

Spécifie un ensemble d’indicateurs qui contrôlent le fonctionnement de la boîte de dialogue. Peut être défini sur l’une des valeurs suivantes :

Indicateur	Signification
0	Comportement par défaut
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Limitez la sélection d’image à une seule image dans la boîte de dialogue d’acquisition d’image d’appareil.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Utilisez l’interface utilisateur système, si disponible, plutôt que l’interface utilisateur fournie par le fournisseur. Si l’interface utilisateur système n’est pas disponible, l’interface utilisateur du fournisseur est utilisée. Si aucune interface utilisateur n’est disponible, la fonction retourne E_NOTIMPL.

 

hwndParent

Type : HWND

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

bstrFolderName

Type : BSTR

Spécifie le nom du dossier dans lequel les fichiers sont transférés.

bstrFilename

Type : BSTR

Spécifie 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.

lNumFiles

Type : LONG

Reçoit le nombre de chaînes écrites dans le tableau pbstrFilePaths .

pbstrFilePaths

Type : BSTR*

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é vers le dossier identifié par bstrFolderName. La méthode doit allouer le stockage pour ce membre.

ppWiaItem

Type : IWiaItem2*

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

Spécifications