wiasUpdateScanRect-Funktion (wiamdef.h)

Die wiasUpdateScanRect-Funktion aktualisiert die Scanbereichsgrößen des Scangeräts.

Syntax

HRESULT wiasUpdateScanRect(
  [in] BYTE                 *pWiasContext,
  [in] WIA_PROPERTY_CONTEXT *pContext,
       LONG                 lWidth,
       LONG                 lHeight
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

[in] pContext

Zeiger auf eine WIA_PROPERTY_CONTEXT Struktur, die den Eigenschaftenkontext enthält, der durch einen vorherigen Aufruf von wiasCreatePropContext erstellt wurde.

lWidth

Gibt die horizontale Breite des Scanbereichs des Scangeräts in Einheiten von Tausendstel eines Zolls an. Normalerweise ist dies die horizontale Bettgröße.

lHeight

Gibt die vertikale Höhe des Scanbereichs des Scangeräts in Einheiten von tausendstel Zoll an. Normalerweise ist dies die vertikale Bettgröße.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA_ERROR_XXX Fehler zurück (in der Microsoft Windows SDK-Dokumentation beschrieben).

Hinweise

Diese Hilfsmethode wird aufgerufen, um die Eigenschaften des Scanrechtecks zu aktualisieren. Die entsprechenden Änderungen werden an den Eigenschaften vorgenommen, die von denen abhängig sind, aus denen das Scanrechteck besteht. Beispielsweise wirkt sich eine Änderung der horizontalen Auflösung auf die horizontale Ausdehnung aus. Diese Funktion setzt voraus, dass die gültigen Werte für die vertikalen und horizontalen Ausdehnungen sowie für vertikale und horizontale Positionen noch nicht aktualisiert wurden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows Me und in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile wiamdef.h (einschließlich Wiamdef.h)
Bibliothek Wiaservc.lib
DLL Wiaservc.dll

Weitere Informationen

WIA_PROPERTY_CONTEXT

wiasCreatePropContext