IWiaDevMgr2::SelectDeviceDlg-Methode
Zeigt ein Dialogfeld an, mit dem der Benutzer ein Hardwaregerät für die Bilderfassung auswählen kann.
Syntax
HRESULT SelectDeviceDlg(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[in, out] BSTR *pbstrDeviceID,
[out, retval] IWiaItem2 **ppItemRoot
);
Parameter
-
hwndParent [in]
-
Typ: HWND
Gibt das übergeordnete Fenster des Dialogfelds Gerät auswählen an.
-
lDeviceType [in]
-
Typ: LONG
Gibt an, welcher Typ des WIA 2.0-Geräts verwendet werden soll. Eine Liste möglicher Werte finden Sie unter WIA-Gerätetypbezeichner .
-
lFlags [in]
-
Typ: LONG
Gibt das Verhalten des Dialogfelds an. Der Wert kann einer der folgenden Sein.
-
0
-
Verwendet das Standardverhalten.
-
WIA_SELECT_DEVICE_NODEFAULT
-
Zeigt das Dialogfeld an, obwohl nur ein übereinstimmende Gerät vorhanden ist.
pbstrDeviceID [in, out]
Typ: BSTR*
Empfängt bei der Ausgabe eine Zeichenfolge, die die Bezeichnerzeichenfolge des Geräts enthält. Übergeben Sie bei der Eingabe die Adresse eines Zeigers, wenn diese Informationen benötigt werden, oder NULL , wenn sie nicht benötigt wird.
ppItemRoot [out, retval]
Typ: IWiaItem2**
Empfängt die Adresse eines Zeigers auf die IWiaItem2-Schnittstelle des Stammelements der hierarchischen Struktur, das das ausgewählte WIA 2.0-Gerät darstellt. Wenn kein Gerät gefunden wird, empfängt es NULL.
Rückgabewert
Typ: HRESULT
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Gerät wurde erfolgreich ausgewählt. |
|
Der Benutzer hat das Dialogfeld abgebrochen. |
|
Keine WIA 2.0-Hardwaregeräte entsprechen den Spezifikationen im lDeviceType-Parameter . |
Bemerkungen
Mit dieser Methode wird das Dialogfeld Gerät auswählen erstellt und angezeigt, damit der Benutzer ein WIA 2.0-Gerät für die Bilderfassung auswählen kann. Wenn ein Gerät erfolgreich ausgewählt wurde, erstellt die IWiaDevMgr2::SelectDeviceDlg-Methode eine hierarchische Struktur von IWiaItem2-Objekten für das Gerät. Es speichert einen Zeiger auf die IWiaItem2-Schnittstelle des Stammelements im Parameter ppItemRoot.
Die Anwendung kann die dem Benutzer angezeigten Geräte auf bestimmte Typen beschränken, indem sie die Gerätetypen über den lDeviceType-Parameter angibt . Wenn nur ein Gerät die Spezifikation erfüllt, zeigt IWiaDevMgr2::SelectDeviceDlg das Dialogfeld Gerät auswählen nicht an. Stattdessen erstellt es die IWiaItem2-Struktur für das Gerät und speichert einen Zeiger auf die IWiaItem2-Schnittstelle des Stammelements im Parameter ppItemRoot. Sie können dieses Verhalten überschreiben und erzwingen, dass IWiaDevMgr2::SelectDeviceDlg das Dialogfeld anzeigt, indem Sie WIA_SELECT_DEVICE_NODEFAULT als Wert für den lFlags-Parameter angeben. Wenn mehr als ein WIA 2.0-Gerät der Spezifikation entspricht, werden alle übereinstimmenden Geräte im Dialogfeld Gerät auswählen angezeigt, sodass der Benutzer eines auswählen kann.
Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppItemRoot-Parameter empfangen.
Hinweis
Es wird empfohlen, dass Anwendungen die Geräte- und Bildauswahl über ein Menüelement mit dem Namen Von Scanner im Menü Datei verfügbar machen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| IDL |
|