IWiaItem2::D eviceDlg-Methode
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 |
|
| IDL |
|