Méthode IWiaItem2::D eviceDlg

Article
06/12/2023

Affiche une boîte de dialogue destinée à l’utilisateur pour 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 [in]

Type : LONG

Spécifie un ensemble d’indicateurs qui contrôlent le fonctionnement 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 WIA_DEVICE_DIALOG décrits dans WiaFlag.

hwndParent [in]

Type : HWND

Handle de la fenêtre parente.

bstrFolderName [in]

Type : BSTR

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

bstrFilename [in]

Type : BSTR

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

plNumFiles [in]

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 pour les fichiers analysés. Initialisez le pointeur pour qu’il pointe vers un tableau de taille zéro (0) avant que IWiaItem2::D eviceDlg soit appelé.

ppIWiaItem2 [in, out]

Type : IWiaItem2**

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

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Notes

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

Une fois cette méthode retournée, 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’elles 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 Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Wia.h
IDL	Wia.idl