Bibliothek für WIA-Treiberdienste
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. |