Méthode IWiaDevMgr2::SelectDeviceDlgID
Affiche une boîte de dialogue qui permet à l’utilisateur de sélectionner un appareil 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
-
hwndParent [in]
-
Type : HWND
Spécifie la fenêtre parente de la boîte de dialogue Sélectionner un appareil .
-
lDeviceType [in]
-
Type : LONG
Spécifie le type d’appareil WIA 2.0 à utiliser. Pour obtenir la liste des valeurs possibles , consultez Spécificateurs de type d’appareil WIA .
-
lFlags [in]
-
Type : LONG
Spécifie le comportement de la boîte de dialogue. La valeur peut être l’une des suivantes.
-
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.
pbstrDeviceID [out, retval]
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 peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
L’appareil a été sélectionné avec succès. |
|
L’utilisateur a annulé la boîte de dialogue. |
|
Aucun appareil matériel WIA 2.0 ne correspond aux spécifications fournies dans le paramètre lDeviceType . |
Notes
Cette méthode crée et affiche la boîte de dialogue Sélectionner un appareil afin que l’utilisateur puisse sélectionner un appareil WIA 2.0 pour l’acquisition d’images. Si un appareil est sélectionné avec succès, la méthode IWiaDevMgr2::SelectDeviceDlgID transmet sa chaîne d’identificateur à l’application via son paramètre pbstrDeviceID .
L’application peut limiter les appareils affichés à l’utilisateur à des types particuliers en spécifiant les types d’appareils via le paramètre lDeviceType . Si un seul appareil répond à la spécification, IWiaDevMgr2::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 IWiaDevMgr2::SelectDeviceDlgID à afficher la boîte de dialogue en passant WIA_SELECT_DEVICE_NODEFAULT comme valeur pour le paramètre lFlags . Si plusieurs appareils WIA 2.0 correspondent à la spécification, tous les appareils correspondants sont affichés dans la boîte de dialogue SélectionnerAppareil afin que l’utilisateur puisse en choisir un.
Notes
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 dans le menu Fichier .
Configuration requise
| 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 |
|
| IDL |
|