IWiaItem2::D eviceDlg-Methode

Artikel
06/13/2023

Zeigt dem Benutzer ein Dialogfeld an, um sich auf die Bilderfassung vorzubereiten.

Syntax

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

Parameter

lFlags [in]

Typ: LONG

Gibt einen Satz von Flags an, die den Vorgang des Dialogfelds steuern. Der Wert kann entweder 0 sein, um das Standardverhalten darzustellen, oder eines der in WiaFlag beschriebenen WIA_DEVICE_DIALOG Flags.

hwndParent [in]

Typ: HWND

Ein Handle für das übergeordnete Fenster.

bstrFolderName [in]

Typ: BSTR

Gibt den Ordnernamen an, in den die Dateien übertragen werden sollen.

bstrFilename [in]

Typ: BSTR

Gibt den Namen der Vorlagendatei an.

plNumFiles [in]

Typ: LONG*

Ein Zeiger auf die Anzahl der Elemente im ppbstrFilePaths-Array .

ppbstrFilePaths [in, out]

Typ: BSTR**

Die Adresse eines Zeigers auf ein Array von Pfaden für die gescannten Dateien. Initialisieren Sie den Zeiger, um auf ein Array der Größe 0 (0) zu zeigen, bevor IWiaItem2::D eviceDlg aufgerufen wird.

ppIWiaItem2 [in, out]

Typ: IWiaItem2**

Die Adresse eines Arrays von Zeigern auf IWiaItem2-Schnittstellen .

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Diese Methode zeigt dem Benutzer ein Dialogfeld an, das eine Anwendung verwendet, um alle informationen zu sammeln, die für die Bilderfassung erforderlich sind. Es wird auch verwendet, um Bildscaneigenschaften wie Helligkeit und Kontrast anzugeben.

Nachdem diese Methode zurückgegeben wurde, kann die Anwendung die IWiaTransfer-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 ppIWiaItem2-Parameter empfangen. Anwendungen müssen das Array auch mithilfe von CoTaskMemFree freigeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl

Freigeben über