IWiaDevMgr2 :: SelectDeviceDlg, méthode

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 SelectDeviceDlg(
  [in]          HWND      hwndParent,
  [in]          LONG      lDeviceType,
  [in]          LONG      lFlags,
  [in, out]     BSTR      *pbstrDeviceID,
  [out, retval] IWiaItem2 **ppItemRoot
);

Paramètres

hwndParent [ dans]

Type : HWND

Spécifie la fenêtre parente de la boîte de dialogue Sélectionner un périphérique .

lDeviceType [ dans]

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 [ dans]

Type : long

Spécifie le comportement de la boîte de dialogue. La valeur peut être l’une des suivantes.

entre

Utiliser le comportement par défaut.

WIA- _ Sélectionner un _ appareil _ par défaut

Affiche la boîte de dialogue même s’il n’y a qu’un seul appareil correspondant.

pbstrDeviceID [ in, out]

Type : BSTR *

Lors de la sortie, reçoit une chaîne qui contient la chaîne d’identificateur de l’appareil. En entrée, transmettez l’adresse d’un pointeur si ces informations sont nécessaires, ou la valeur null si elle n’est pas nécessaire.

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é, la valeur null est reçue.

Valeur de retour

Type : HRESULT

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
_OK
L’appareil a été sélectionné avec succès.
S _ false
L’utilisateur a annulé la boîte de dialogue.
WIA _ - _ aucun _ appareil _ disponible
Aucun périphérique matériel WIA 2,0 ne correspond aux spécifications indiquées 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 :: SelectDeviceDlg crée une arborescence hiérarchique d’objets IWiaItem2 pour l’appareil. Elle 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 périphérique répond à la spécification, IWiaDevMgr2 :: SelectDeviceDlg n’affiche pas la boîte de dialogue Sélectionner un périphérique . 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 du paramètre lFlags . Si plus d’un appareil WIA 2,0 correspond à la spécification, tous les appareils correspondants s’affichent dans la boîte de dialogue Sélectionner un périphérique 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é que les applications rendent la sélection de l’appareil et de l’image disponible via un élément de menu nommé à partir de scanner dans le menu fichier .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
WIA. h
MIDL
WIA. idl