Freigeben über

Bibliothek für WIA-Treiberdienste

  • Artikel

Die BIBLIOTHEK der WIA-Treiberdienste enthält Funktionen, die ein WIA-Minidriver zur Unterstützung bei der Ausführung der folgenden Aufgaben aufrufen kann:

Ein WIA-Minidriver ruft die meisten dieser Funktionen bei Bedarf über seine IWiaMiniDrv-Schnittstellenmethoden auf. Jeder WIA-Minidriver muss jedoch die wiasCreateDrvItem-Funktion in der IWiaMiniDrv::d rvInitializeWia-Methode aufrufen, um Treiberelemente zu erstellen. Jeder erfolgreiche Aufruf einer wiasCreateDrvItem-Funktion erstellt ein IWiaDrvItem-Elementobjekt , das in der Elementstruktur des Minidrivers verwendet wird. Mehrere Methoden der IWiaDrvItem-Schnittstelle verfügen über einen Parameter vom Typ IWiaDrvItem::AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem und IWiaDrvItem::GetParentItem. Außerdem verfügt die wiasGetDrvItem-Funktion über einen Parameter dieses Typs.

Die Treiberdienstebibliothek stellt die folgenden Funktionen bereit.

Erstellen und Verwalten einer Elementstruktur

Funktion BESCHREIBUNG
wiasCreateChildAppItem Erstellt ein neues Anwendungselement und fügt es als untergeordnetes Element des angegebenen (übergeordneten) Elements ein.
wiasCreateDrvItem Erstellt ein IWiaDrvItem-Objekt .
wiasGetChildrenContexts Ruft ein Array von Elementkontexten ab, die zu den untergeordneten Elementen des aktuellen Elements gehören.
wiasGetContextFromName Ruft den Elementkontext für einen Elementnamen ab.
wiasGetDrvItem Ruft ein Treiberelement ab.
wiasGetRootItem Ruft den Stammelementkontext eines angegebenen WIA-Elements ab.

Protokollieren von Fehler- und Ablaufverfolgungsmeldungen

Funktion BESCHREIBUNG
wiasCreateLogInstance Erstellt eine instance eines Protokollierungsobjekts.
wiasDebugError Gibt eine Debugfehlerzeichenfolge in der Geräte-Manager Debugkonsole aus. Die Ausgabefarbe ist immer rot. Diese Funktion wird nur aus Gründen der Kompatibilität bereitgestellt. Es wird empfohlen, stattdessen WIAS_ERROR zu verwenden.
wiasDebugTrace Gibt eine Debugablaufverfolgungszeichenfolge in der Geräte-Manager Debugkonsole aus. Diese Funktion wird nur aus Gründen der Kompatibilität bereitgestellt. Es wird empfohlen, stattdessen WIA_TRACE zu verwenden.
wiasFormatArgs Formatiert eine Argumentliste in eine gepackte Zeichenfolge für die Protokollierung.
wiasPrintDebugHResult Gibt eine HRESULT-Zeichenfolge auf der Geräte-Manager Debugkonsole aus. Diese Funktion wird nur aus Gründen der Kompatibilität bereitgestellt. Sie ist veraltet und wird nicht mehr unterstützt. Verwenden Sie stattdessen WIAS_LHRESULT .

Lesen und Speichern von Elementeigenschaften

Funktion BESCHREIBUNG
wiasCreatePropContext Weist einen Eigenschaftenkontext zu, um anzugeben, welche Eigenschaften eines Elements sich ändern.
wiasFreePropContext Gibt den von einer WIA_PROPERTY_CONTEXT-Struktur belegten Arbeitsspeicher frei.
wiasGetChangedValueFloat Bestimmt, ob eine Eigenschaft mit einem Gleitkommawert von einer Anwendung geändert wurde.
wiasGetChangedValueGuid Bestimmt, ob eine Eigenschaft mit einem GUID-Wert von einer Anwendung geändert wurde.
wiasGetChangedValueLong Bestimmt, ob eine Eigenschaft mit einem langen ganzzahligen Wert von einer Anwendung geändert wurde.
wiasGetChangedValueStr Bestimmt, ob eine Eigenschaft mit einem Zeichenfolgenwert von einer Anwendung geändert wurde.
wiasGetItemType Gibt ein Stamm- oder untergeordnetes Element an.
wiasGetPropertyAttributes Ruft die Zugriffsflags und gültigen Werte für einen Satz von Eigenschaften ab.
wiasIsPropChanged Testet, ob die angegebene Eigenschaft von einer Anwendung geändert wurde.
wiasReadMultiple Liest mehrere Eigenschaften aus einem WIA-Element.
wiasReadPropBin Liest eine einzelne binäre Eigenschaft aus einem WIA-Element.
wiasReadPropFloat Ruft einen Gleitkommaeigenschaftswert aus einem WIA-Element ab.
wiasReadPropGuid Ruft einen GUID-Eigenschaftswert aus einem WIA-Element ab.
wiasReadPropLong Ruft einen langen ganzzahligen Eigenschaftswert aus einem WIA-Element ab.
wiasReadPropStr Ruft einen Zeichenfolgeneigenschaftswert aus einem WIA-Element ab.
wiasSetItemPropAttribs Legt die Zugriffsflags und gültigen Werte für die Eigenschaften eines Elements fest.
wiasSetItemPropNames Schreibt Eigenschaftennamen in Elementeigenschaften.
wiasSetPropChanged Ändert einen Eigenschaftenkontext, um anzugeben, dass eine Eigenschaft geändert wird.
wiasSetPropertyAttributes Legt die Zugriffsflags und Eigenschaftswerte der Eigenschaften eines Elements fest.
wiasSetValidFlag Legt die gültigen Werte für eine WIA_PROP_FLAG-Eigenschaft fest.
wiasSetValidListFloat Legt die gültigen Werte für eine WIA_PROP_LIST-Eigenschaft vom Typ sub-VT_R4 fest.
wiasSetValidListGuid Legt die gültigen Werte für eine WIA_PROP_LIST Eigenschaft des Subtyps VT_CLSID fest.
wiasSetValidListLong Legt die gültigen Werte für eine WIA_PROP_LIST-Eigenschaft vom Typ sub-VT_I4 fest.
wiasSetValidListStr Legt die gültigen Werte für eine WIA_PROP_LIST-Eigenschaft vom Typ sub-VT_BSTR fest.
wiasSetValidRangeFloat Gibt den Bereich der gültigen Werte für eine WIA_PROP_RANGE Eigenschaft des Subtyps VT_R4 an.
wiasSetValidRangeLong Gibt den Bereich der gültigen Werte für eine WIA_PROP_RANGE Eigenschaft des Untertyps VT_I4 an.
wiasUpdateValidFormat Updates das gültige Format des Eigenschaftenkontexts für den aktuellen Minidriver.
wiasValidateItemProperties Überprüft eine Liste einfacher Elementeigenschaften anhand ihrer aktuellen gültigen Werte.
wiasWriteMultiple Schreibt mehrere Eigenschaftswerte in ein WIA-Element (die Eigenschaften können unterschiedlicher Typen sein).
wiasWritePropBin Schreibt einen einzelnen binären Eigenschaftswert in ein WIA-Element.
wiasWritePropFloat Schreibt einen Gleitkommaeigenschaftswert in ein WIA-Element.
wiasWritePropGuid Schreibt einen GUID-Eigenschaftswert in ein WIA-Element.
wiasWritePropLong Schreibt einen langen ganzzahligen Eigenschaftswert in ein WIA-Element.
wiasWritePropStr Schreibt einen Zeichenfolgeneigenschaftswert in ein WIA-Element.

Aktualisieren und Übertragen von Daten

Funktion BESCHREIBUNG
wiasDownSampleBuffer Übernimmt einen Puffer mit Pixeldaten und verknampelt ihn auf die angegebene Größe.
wiasGetImageInformation Ruft Übertragungskontextinformationen aus einem Element ab.
wiasParseEndorserString Analysiert eine Endorserzeichenfolge und ersetzt vom WIA-Dienst definierte und vom Anbieter definierte Token in der Zeichenfolge durch Werte, die den Token zugeordnet sind.
wiasSendEndOfPage Ruft die Clientrückrufroutine während einer Datenübertragung auf, und sendet die aktuelle Gesamtanzahl der Seiten.
wiasUpdateScanRect Updates die Scanbereichsgrößen des Scangeräts.
wiasWriteBufToFile Schreibt den Inhalt eines temporären Seitenpuffers in eine Bilddatei.
wiasWritePageBufToFile Schreibt den Inhalt eines temporären Seitenpuffers in eine Bilddatei. Verwenden Sie diese Funktion, um eine Seite in eine mehrseitige TIFF-Datei zu schreiben.