wiasSetItemPropAttribs-Funktion (wiamdef.h)
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 |