IWiaItem::D eviceDlg-Methode (wia_xp.h)

Artikel
03/03/2024

Die IWiaItem::D eviceDlg-Methode wird von Anwendungen verwendet, um dem Benutzer ein Dialogfeld anzuzeigen, um die Bildaufnahme vorzubereiten.

Syntax

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

Parameter

[in] hwndParent

Typ: HWND

Handle des übergeordneten Fensters des Dialogfelds.

[in] lFlags

Typ: LONG

Gibt eine Reihe von Flags an, die den Vorgang des Dialogfelds steuern. Kann auf einen der folgenden Werte festgelegt werden:

Flag	Bedeutung
0	Standardverhalten.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Beschränken Sie die Bildauswahl auf ein einzelnes Bild im Dialogfeld Gerätebilderfassung.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Verwenden Sie die Systembenutzeroberfläche, falls verfügbar, anstelle der vom Anbieter bereitgestellten Benutzeroberfläche. Wenn die System-Benutzeroberfläche nicht verfügbar ist, wird die Anbieter-UI verwendet. Wenn keine benutzeroberfläche verfügbar ist, gibt die Funktion E_NOTIMPL zurück.

[in] lIntent

Typ: LONG

Gibt an, welchen Datentyp das Image darstellen soll. Eine Liste der Bildabsichtswerte finden Sie unter Image Intent Constants.

Hinweis Diese Methode ignoriert alle WIA_INTENT_IMAGE_*-Bildabsichten.

[out] plItemCount

Typ: LONG*

Empfängt die Anzahl der Elemente in dem Array, die durch den ppIWiaItem-Parameter angegeben wird.

[out] ppIWiaItem

Typ: IWiaItem***

Empfängt die Adresse eines Arrays von Zeigern auf IWiaItem-Schnittstellen .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode zeigt dem Benutzer ein Dialogfeld an, das eine Anwendung verwendet, um alle für die Bildaufnahme erforderlichen Informationen zu sammeln. Für instance können Benutzer in diesem Dialogfeld Bilder auswählen, die von einer Kamera heruntergeladen werden sollen. Bei Verwendung eines Scanners wird er auch verwendet, um Bildscaneigenschaften wie Helligkeit und Kontrast anzugeben.

Nachdem diese Methode zurückgegeben wurde, kann die Anwendung die IWiaDataTransfer-Schnittstelle verwenden, um das Image zu erhalten.

Anwendungen müssen die IUnknown::Release-Methode für jedes Element im Array der Schnittstellenzeiger aufrufen, die sie über den ppIWiaItem-Parameter empfangen. Anwendungen müssen das Array auch mithilfe von CoTaskMemFree freigeben.

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

Anforderung	Wert
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 (einschließlich Wia.h)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Freigeben über