Méthode IWiaDevMgr2::SelectDeviceDlg
Affiche une boîte de dialogue qui permet à l’utilisateur de sélectionner un appareil matériel pour l’acquisition d’images.
Syntaxe
HRESULT SelectDeviceDlg(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[in, out] BSTR *pbstrDeviceID,
[out, retval] IWiaItem2 **ppItemRoot
);
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 [in, out]
Type : BSTR*
À la sortie, reçoit une chaîne qui contient la chaîne d’identificateur de l’appareil. Lors de l’entrée, transmettez l’adresse d’un pointeur si ces informations sont nécessaires, ou NULL si elles ne sont pas nécessaires.
ppItemRoot [out, retval]
Type : IWiaItem2**
Reçoit l’adresse d’un pointeur vers l’interface IWiaItem2 de l’élément racine de l’arborescence hiérarchique qui représente l’appareil WIA 2.0 sélectionné. Si aucun appareil n’est trouvé, il reçoit la valeur NULL.
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é. |
|
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é, la méthode IWiaDevMgr2::SelectDeviceDlg crée une arborescence hiérarchique d’objets IWiaItem2 pour l’appareil. Il stocke un pointeur vers l’interface IWiaItem2 de l’élément racine dans le paramètre ppItemRoot.
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::SelectDeviceDlg n’affiche pas la boîte de dialogue Sélectionner un appareil . Au lieu de cela, il crée l’arborescence IWiaItem2 pour l’appareil et stocke un pointeur vers l’interface IWiaItem2 de l’élément racine dans le paramètre ppItemRoot. Vous pouvez remplacer ce comportement et forcer IWiaDevMgr2::SelectDeviceDlg à afficher la boîte de dialogue en spécifiant 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 s’affichent dans la boîte de dialogue Sélectionner un appareil afin que l’utilisateur puisse en choisir un.
Les applications doivent appeler la méthode IUnknown::Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre ppItemRoot .
Notes
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 dans le menu Fichier .
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 |
|
| IDL |
|