IWiaDevMgr2::SelectDeviceDlgID-Methode
Zeigt ein Dialogfeld an, mit dem der Benutzer ein Hardwaregerät für die Bilderfassung 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 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 [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 |
|---|---|
|
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, übergibt die IWiaDevMgr2::SelectDeviceDlgID-Methode ihre Bezeichnerzeichenfolge über den pbstrDeviceID-Parameter an die Anwendung.
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::SelectDeviceDlgID das Dialogfeld Gerät auswählen nicht an. Stattdessen übergibt es die Bezeichnerzeichenfolge des Geräts an die Anwendung, ohne das Dialogfeld anzuzeigen. Sie können dieses Verhalten überschreiben und erzwingen, dass IWiaDevMgr2::SelectDeviceDlgID das Dialogfeld anzeigt, 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 SelectDevice angezeigt, sodass der Benutzer eines auswählen kann.
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 |
|