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
S _ OK
Das Gerät wurde erfolgreich ausgewählt.
S _ FALSE
Der Benutzer hat das Dialogfeld abgebrochen.
WIA _ S KEIN GERÄT _ _ _ VERFÜGBAR
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
Wia.h
IDL
Wia.idl