IWiaItem ::D eviceDlg, méthode (wia_xp.h)

Article
03/03/2024

La méthode IWiaItem ::D eviceDlg est utilisée par les applications pour afficher une boîte de dialogue à l’utilisateur afin de préparer l’acquisition d’images.

Syntaxe

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

Paramètres

[in] hwndParent

Type : HWND

Handle de la fenêtre parente de la boîte de dialogue.

[in] lFlags

Type : LONG

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.

[in] lIntent

Type : LONG

Spécifie le type de données que l’image est destinée à représenter. Pour obtenir la liste des valeurs d’intention d’image, consultez Constantes d’intention d’image.

Note Cette méthode ignore toutes les intentions d’image WIA_INTENT_IMAGE_*.

[out] plItemCount

Type : LONG*

Reçoit le nombre d’éléments du tableau indiqué par le paramètre ppIWiaItem .

[out] ppIWiaItem

Type : IWiaItem***

Reçoit l’adresse d’un tableau de pointeurs vers les interfaces IWiaItem .

Valeur retournée

Type : HRESULT

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

Remarques

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. Pour instance, cette boîte de dialogue permet à l’utilisateur de sélectionner des images à télécharger à partir d’un appareil photo. Lors de l’utilisation d’un scanneur, 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 IWiaDataTransfer 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 ppIWiaItem . Les applications doivent également libérer le tableau à l’aide de CoTaskMemFree.

Il est recommandé que les applications rendent la sélection de l’appareil et de l’image disponible via un élément de menu nommé À partir du scanneur ou de l’appareil photo dans le menu Fichier .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wia_xp.h (incluez Wia.h)
Bibliothèque	Wiaguid.lib
DLL	Wiaservc.dll

Partager via