wiasSetItemPropAttribs-Funktion (wiamdef.h)

Artikel
03/13/2023

Die wiasSetItemPropAttribs-Funktion legt die Zugriffsflags und gültigen Werte für die Eigenschaften eines Elements fest.

Syntax

HRESULT wiasSetItemPropAttribs(
  [in] BYTE               *pWiasContext,
       LONG               cPropSpec,
  [in] PROPSPEC           *pPropSpec,
  [in] PWIA_PROPERTY_INFO pwpi
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

cPropSpec

Gibt die Anzahl der Eigenschaften an.

[in] pPropSpec

Zeiger auf das erste Element eines Arrays von PROPSPEC-Strukturen (definiert in der Microsoft Windows SDK-Dokumentation), das die Eigenschaften angibt, für die gültige Werte und Zugriffsflags festgelegt werden sollen.

[in] pwpi

Zeiger auf das erste Element eines Arrays von WIA_PROPERTY_INFO Strukturen, die die zu schreibenden Eigenschaftswerte enthalten.

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 Windows SDK-Dokumentation beschrieben).

Hinweise

Minidriver sollten diese Funktion verwenden, um Gruppen einfacher Eigenschaften zu initialisieren. Die Gruppen von Eigenschaften können Bitsets, Wertebereiche oder Wertelisten sein. Die unterstützten einfachen Typen, gruppiert nach Attribut, sind wie folgt.

Attribute	Unterstützte Typen
WIA_PROP_FLAG	VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_I8
WIA_PROP_RANGE	VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_I8, VT_R4, VT_R8
WIA_PROP_LIST	VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_I8, VT_R4, VT_R8, VT_BSTR

Minidriver sollten komplexe Eigenschaften mithilfe der funktion wiasSetPropertyAttributes initialisieren.

Der Minidriver kann das WIA_PROP_CACHEABLE-Flag für eine Eigenschaft festlegen, die sich im Laufe der Zeit nicht ändert. Durch Festlegen dieses Flags für eine Eigenschaft gibt der Minidriver an, dass der WIA-Dienst den Eigenschaftswert zwischenspeichern kann. Eine Liste aller Eigenschaftenattribute finden Sie in der Windows SDK-Dokumentation.

Beachten Sie, dass wiasSetItemPropAttribs ein HRESULT und kein BOOLEAN zurückgibt. Wenn beispielsweise wiasSetItemPropAttribs 0 zurückgibt, muss dieser Wert als S_OK statt als FALSE interpretiert werden und gibt an, dass alles wie erwartet funktioniert hat. Wenn wiasSetItemPropAttribs den HRESULT-S_FALSE zurückgibt, bedeutet dies, dass eine der Eigenschaften, die Sie festlegen möchten, wahrscheinlich nicht im Eigenschaftenstream vorhanden ist.

Um ein wiadebug-Protokoll dieses Fehlers abzurufen, öffnen Sie die Registrierung, und aktivieren Sie die WIA-Protokollierung für Warnungen und Fehler. Der Registrierungsschlüssel hierfür lautet :HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\StillImage\Debug\wiaservc.dll

Legen Sie den Wert von "DebugFlags" auf 0x00000003

Starten Sie das System neu, und wiederholen Sie die erforderlichen Schritte, um diesen Fehler zu erzeugen. Im Verzeichnis %windir% befindet sich nun eine Datei mit dem Namen "wiadebug.log".

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wiamdef.h (einschließlich Wiamdef.h)
Bibliothek	Wiaservc.lib
DLL	Wiaservc.dll

Weitere Informationen

WIA_PROPERTY_INFO

wiasSetItemPropNames

wiasSetPropertyAttributes

Freigeben über