IWiaDevMgr2::SelectDeviceDlgID-Methode
Zeigt ein Dialogfeld an, in dem der Benutzer ein Hardwaregerät für die Imageerfassung auswählen kann.
Syntax
HRESULT SelectDeviceDlgID(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[out, retval] BSTR *pbstrDeviceID
);
Parameter
-
hwndParent [ In]
-
Typ: HWND
Gibt das übergeordnete Fenster des Dialogfelds Gerät auswählen an.
-
lDeviceType [ In]
-
Typ: LONG
Gibt an, welcher Typ von WIA 2.0-Gerät verwendet werden soll. Eine Liste der möglichen Werte finden Sie unter WIA-Gerätetypspezifizierer.
-
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
-
Das Dialogfeld wird angezeigt, obwohl es nur ein passendes Gerät gibt.
pbstrDeviceID [ out, retval]
Typ: BSTR *
Zeiger auf eine Zeichenfolge, die die Bezeichnerzeichenfolge des Geräts empfängt.
Rückgabewert
Typ: HRESULT
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Gerät wurde erfolgreich ausgewählt. |
|
Der Benutzer hat das Dialogfeld abgebrochen. |
|
Keine WIA 2.0-Hardwaregeräte entsprechen den Im lDeviceType-Parameter angegebenen Spezifikationen. |
Bemerkungen
Diese Methode erstellt und zeigt das Dialogfeld Gerät auswählen an, damit der Benutzer ein WIA 2.0-Gerät für die Bilderfassung auswählen kann. Wenn ein Gerät erfolgreich ausgewählt wurde, übergibt die IWiaDevMgr2::SelectDeviceDlgID-Methode seine Bezeichnerzeichenfolge über den parameter pbstrDeviceID an die Anwendung.
Die Anwendung kann die für den Benutzer angezeigten Geräte auf bestimmte Typen beschränken, indem sie die Gerätetypen über den Parameter lDeviceType angibt. Wenn nur ein Gerät die Spezifikation erfüllt, zeigt IWiaDevMgr2::SelectDeviceDlgID das Dialogfeld Gerät auswählen nicht an. Stattdessen wird die Bezeichnerzeichenfolge des Geräts an die Anwendung übergeben, ohne das Dialogfeld anzuzeigen. Sie können dieses Verhalten außer Kraft setzen und IWiaDevMgr2::SelectDeviceDlgID zwingen, das Dialogfeld anzuzeigen, indem Sie WIA SELECT DEVICE NODEFAULT als Wert für den _ _ _ lFlags-Parameter übergeben. Wenn mehr als ein WIA 2.0-Gerät der Spezifikation entspricht, werden alle übereinstimmenden Geräte im Dialogfeld AuswählenGeräte angezeigt, damit der Benutzer eines auswählen kann.
Hinweis
Es wird empfohlen, dass Anwendungen die Geräte- und Bildauswahl über ein Menüelement namens From scanner im Menü Datei verfügbar machen.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| IDL |
|