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 |
|
| MIDL |
|