IWiaDevMgr::SelectDeviceDlgID-Methode (wia_xp.h)

Artikel
08/27/2023

Die IWiaDevMgr::SelectDeviceDlgID-Methode zeigt ein Dialogfeld an, in 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

[in] hwndParent

Typ: HWND

Handle des Fensters, das besitzer des Dialogfelds Gerät auswählen ist.

[in] lDeviceType

Typ: LONG

Gibt an, welcher Typ von WIA-Gerät verwendet werden soll. Kann auf StiDeviceTypeDefault, StiDeviceTypeScanner oder StiDeviceTypeDigitalCamera festgelegt werden.

[in] lFlags

Typ: LONG

Gibt das Dialogfeldverhalten an. Kann auf einen der folgenden Werte festgelegt werden:

Konstante	Bedeutung
0	Verwendet das Standardverhalten.
WIA_SELECT_DEVICE_NODEFAULT	Zeigt das Dialogfeld auch dann an, wenn nur ein übereinstimmende Gerät vorhanden ist. Weitere Informationen finden Sie im Abschnitt Hinweise auf dieser Referenzseite.

[out, retval] pbstrDeviceID

Typ: BSTR*

Zeiger auf eine Zeichenfolge, die die Bezeichnerzeichenfolge des Geräts empfängt.

Rückgabewert

Typ: HRESULT

Diese Methode gibt die folgenden Werte zurück:

Rückgabewert	Bedeutung
S_OK	Ein Gerät wurde erfolgreich ausgewählt.
S_FALSE	Der Benutzer hat das Dialogfeld abgebrochen.
WIA_S_NO_DEVICE_AVAILABLE	Es sind keine WIA-Hardwaregeräte an den Computer des Benutzers angeschlossen, die den Spezifikationen entsprechen.

Hinweise

Diese Methode funktioniert ähnlich wie IWiaDevMgr::SelectDeviceDlg. Der Hauptunterschied besteht darin, dass die hierarchische Struktur von IWiaItem-Objekten für das Gerät nicht erstellt wird, wenn ein übereinstimmende Gerät gefunden wird.

Wie IWiaDevMgr::SelectDeviceDlg erstellt die IWiaDevMgr::SelectDeviceDlgID-Methode das Dialogfeld Gerät auswählen und zeigt es an. Dadurch kann der Benutzer ein WIA-Gerät für die Bilderfassung auswählen. Wenn ein Gerät erfolgreich ausgewählt wurde, übergibt die IWiaDevMgr::SelectDeviceDlgID-Methode ihre Bezeichnerzeichenfolge über den pbstrDeviceID-Parameter an die Anwendung.

Bestimmte Gerätetypen können dem Benutzer angezeigt werden, indem die Gerätetypen über den lDeviceType-Parameter angegeben werden. Wenn nur ein Gerät die Spezifikation erfüllt, zeigt IWiaDevMgr::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 überschreiben und erzwingen , dass IWiaDevMgr::SelectDeviceDlgID das Dialogfeld Gerät auswählen anzeigt, indem Sie WIA_SELECT_DEVICE_NODEFAULT als Wert für den lFlags-Parameter übergeben.

Wenn mehr als ein WIA-Gerät der Spezifikation entspricht, werden alle übereinstimmenden Geräte im Dialogfeld Gerät auswählen angezeigt, sodass der Benutzer eines auswählen kann.

Es wird empfohlen, dass Anwendungen die Geräte- und Bildauswahl über ein Menüelement mit dem Namen Von Scanner oder Kamera im Menü Datei verfügbar machen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (wia.h einschließen)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Freigeben über