Méthode IWiaDevMgr::SelectDeviceDlgID (wia_xp.h)

Article
08/27/2023

La méthode IWiaDevMgr::SelectDeviceDlgID affiche une boîte de dialogue qui permet à l’utilisateur de sélectionner un périphérique matériel pour l’acquisition d’images.

Syntaxe

HRESULT SelectDeviceDlgID(
  [in]          HWND hwndParent,
  [in]          LONG lDeviceType,
  [in]          LONG lFlags,
  [out, retval] BSTR *pbstrDeviceID
);

Paramètres

[in] hwndParent

Type : HWND

Handle de la fenêtre qui possède la boîte de dialogue Sélectionner un appareil .

[in] lDeviceType

Type : LONG

Spécifie le type d’appareil WIA à utiliser. Peut être défini sur StiDeviceTypeDefault, StiDeviceTypeScanner ou StiDeviceTypeDigitalCamera.

[in] lFlags

Type : LONG

Spécifie le comportement de la boîte de dialogue. Peut être défini sur l’une des valeurs suivantes :

Constant	Signification
0	Utiliser le comportement par défaut.
WIA_SELECT_DEVICE_NODEFAULT	Affichez la boîte de dialogue même s’il n’existe qu’un seul appareil correspondant. Pour plus d’informations, consultez la section Remarques de cette page de référence.

[out, retval] pbstrDeviceID

Type : BSTR*

Pointeur vers une chaîne qui reçoit la chaîne d’identificateur de l’appareil.

Valeur retournée

Type : HRESULT

Cette méthode retourne les valeurs suivantes :

Valeur renvoyée	Signification
S_OK	Un appareil a été sélectionné avec succès.
S_FALSE	L’utilisateur a annulé la boîte de dialogue.
WIA_S_NO_DEVICE_AVAILABLE	Aucun périphérique matériel WIA n’est attaché à l’ordinateur de l’utilisateur qui correspond aux spécifications.

Remarques

Cette méthode fonctionne de la même manière que IWiaDevMgr::SelectDeviceDlg. La principale différence est que s’il trouve un appareil correspondant, il ne crée pas l’arborescence hiérarchique des objets IWiaItem pour l’appareil.

Comme IWiaDevMgr::SelectDeviceDlg, la méthode IWiaDevMgr::SelectDeviceDlgID crée et affiche la boîte de dialogue Sélectionner un appareil . Cela permet à l’utilisateur de sélectionner un appareil WIA pour l’acquisition d’images. Si un appareil est sélectionné, la méthode IWiaDevMgr::SelectDeviceDlgID transmet sa chaîne d’identificateur à l’application via son paramètre pbstrDeviceID .

Des types d’appareils particuliers peuvent être affichés à l’utilisateur en spécifiant les types d’appareils via le paramètre lDeviceType . Si un seul appareil répond à la spécification, IWiaDevMgr::SelectDeviceDlgID n’affiche pas la boîte de dialogue Sélectionner un appareil . Au lieu de cela, il transmet la chaîne d’identificateur de l’appareil à l’application sans afficher la boîte de dialogue. Vous pouvez remplacer ce comportement et forcer IWiaDevMgr::SelectDeviceDlgID à afficher la boîte de dialogue Sélectionner un appareil en passant WIA_SELECT_DEVICE_NODEFAULT comme valeur pour le paramètre lFlags .

Si plusieurs appareils WIA correspondent à la spécification, tous les appareils correspondants s’affichent dans la boîte de dialogue Sélectionner un appareil afin que l’utilisateur puisse en choisir un.

Il est recommandé aux applications de rendre 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


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 (inclure Wia.h)
Bibliothèque	Wiaguid.lib
DLL	Wiaservc.dll

Partager via