IWiaItem2 ::D méthode eviceDlg

Affiche une boîte de dialogue permettant à l’utilisateur de préparer l’acquisition d’images.

Syntaxe

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

Paramètres

lFlags [ dans]

Type : long

Spécifie un jeu d’indicateurs qui contrôlent l’opération de la boîte de dialogue. La valeur peut être 0 pour représenter le comportement par défaut ou l’un des _ indicateurs de boîte de dialogue de périphérique WIA _ décrits dans WiaFlag.

hwndParent [ dans]

Type : HWND

Handle de la fenêtre parente.

bstrFolderName [ dans]

Type : BSTR

Spécifie le nom du dossier dans lequel les fichiers doivent être transférés.

bstrFilename [ dans]

Type : BSTR

Spécifie le nom du fichier de modèle.

plNumFiles [ dans]

Type : long *

Pointeur vers le nombre d’éléments dans le tableau ppbstrFilePaths .

ppbstrFilePaths [ in, out]

Type : BSTR * *

Adresse d’un pointeur vers un tableau de chemins d’accès pour les fichiers analysés. Initialisez le pointeur pour pointer vers un tableau de taille zéro (0) avant IWiaItem2 ::D evicedlg est appelée.

ppIWiaItem2 [ in, out]

Type : IWiaItem2**

Adresse d’un tableau de pointeurs vers des interfaces IWiaItem2 .

Valeur de retour

Type : HRESULT

Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .

Notes

Cette méthode affiche une boîte de dialogue à l’utilisateur qu’une application utilise pour rassembler toutes les informations requises pour l’acquisition d’images. Il est également utilisé pour spécifier des propriétés d’analyse d’images telles que la luminosité et le contraste.

Une fois que cette méthode a retourné une valeur, l’application peut utiliser l’interface IWiaTransfer pour acquérir l’image.

Les applications doivent appeler la méthode IUnknown :: Release pour chaque élément du tableau de pointeurs d’interface qu’ils reçoivent via le paramètre ppIWiaItem2 . Les applications doivent également libérer le tableau à l’aide de CoTaskMemFree.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
WIA. h
MIDL
WIA. idl