Библиотека служб драйверов WIA
Библиотека служб драйверов WIA содержит функции, которые мини-драйвер WIA может вызвать для помощи в выполнении следующих задач:
По мере необходимости мини-накопитель WIA вызывает большинство этих функций из методов интерфейса IWiaMiniDrv . Однако каждый мини-накопитель WIA должен вызывать функцию wiasCreateDrvItem в методе IWiaMiniDrv::d rvInitializeWia для создания элементов драйвера. При каждом успешном вызове функции wiasCreateDrvItem создается объект элемента IWiaDrvItem , который используется в дереве элементов minidriver. Несколько методов интерфейса IWiaDrvItem имеют параметр типа IWiaDrvItem, включая IWiaDrvItem::AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem и IWiaDrvItem::GetParentItem. Кроме того, функция wiasGetDrvItem имеет параметр этого типа.
Библиотека служб драйверов предоставляет следующие функции.
Создание и обслуживание дерева элементов
| Функция | Описание |
|---|---|
| wiasCreateChildAppItem | Создает новый элемент приложения и вставляет его как дочерний элемент указанного (родительского) элемента. |
| wiasCreateDrvItem | Создает объект IWiaDrvItem . |
| wiasGetChildrenContexts | Извлекает массив контекстов элементов, принадлежащих дочерним элементам текущего элемента. |
| wiasGetContextFromName | Извлекает контекст элемента для имени элемента. |
| wiasGetDrvItem | Извлекает элемент драйвера. |
| wiasGetRootItem | Извлекает контекст корневого элемента указанного элемента WIA. |
Сообщения об ошибках журнала и трассировки
| Функция | Описание |
|---|---|
| wiasCreateLogInstance | Создает экземпляр объекта ведения журнала. |
| wiasDebugError | Выводит строку ошибки отладки в консоли отладки диспетчер устройств. Выходной цвет всегда красный. Эта функция предоставляется только для обеспечения совместимости. Вместо этого рекомендуется использовать WIAS_ERROR . |
| wiasDebugTrace | Выводит строку трассировки отладки в консоли отладки диспетчер устройств. Эта функция предоставляется только для обеспечения совместимости. Вместо этого рекомендуется использовать WIA_TRACE . |
| wiasFormatArgs | Форматирует список аргументов в упаковаемую строку для ведения журнала. |
| wiasPrintDebugHResult | Выводит строку HRESULT в консоли отладки диспетчер устройств. Эта функция предоставляется только для обеспечения совместимости. Она устарела и больше не поддерживается. Вместо этого используйте WIAS_LHRESULT . |
Чтение и хранение свойств элемента
| Функция | Описание |
|---|---|
| wiasCreatePropContext | Выделяет контекст свойства, чтобы указать, какие свойства элемента изменяются. |
| wiasFreePropContext | Освобождает память, занятую WIA_PROPERTY_CONTEXT структурой. |
| wiasGetChangedValueFloat | Определяет, было ли изменено приложением свойство со значением с плавающей запятой. |
| wiasGetChangedValueGuid | Определяет, было ли изменено приложением свойство со значением GUID. |
| wiasGetChangedValueLong | Определяет, было ли изменено приложением свойство с длинным целочисленным значением. |
| wiasGetChangedValueStr | Определяет, было ли изменено приложением свойство со строковым значением. |
| wiasGetItemType | Указывает корневой или дочерний элемент. |
| wiasGetPropertyAttributes | Извлекает флаги доступа и допустимые значения для набора свойств. |
| wiasIsPropChanged | Проверяет, было ли указанное свойство изменено приложением. |
| wiasReadMultiple | Считывает несколько свойств из элемента WIA. |
| wiasReadPropBin | Считывает одно двоичное свойство из элемента WIA. |
| wiasReadPropFloat | Извлекает значение свойства с плавающей запятой из элемента WIA. |
| wiasReadPropGuid | Извлекает значение свойства GUID из элемента WIA. |
| wiasReadPropLong | Извлекает длинное целочисленное значение свойства из элемента WIA. |
| wiasReadPropStr | Извлекает строковое значение свойства из элемента WIA. |
| wiasSetItemPropAttribs | Задает флаги доступа и допустимые значения для набора свойств элемента. |
| wiasSetItemPropNames | Записывает имена свойств в свойства элемента. |
| wiasSetPropChanged | Изменяет контекст свойства, чтобы указать, что свойство изменяется. |
| wiasSetPropertyAttributes | Задает флаги доступа и значения свойств элемента. |
| wiasSetValidFlag | Задает допустимые значения для свойства WIA_PROP_FLAG. |
| wiasSetValidListFloat | Задает допустимые значения для свойства WIA_PROP_LIST типа sub-VT_R4. |
| wiasSetValidListGuid | Задает допустимые значения для свойства WIA_PROP_LIST подтипа VT_CLSID. |
| wiasSetValidListLong | Задает допустимые значения для свойства WIA_PROP_LIST типа sub-VT_I4. |
| wiasSetValidListStr | Задает допустимые значения для свойства WIA_PROP_LIST типа sub-VT_BSTR. |
| wiasSetValidRangeFloat | Задает диапазон допустимых значений для свойства WIA_PROP_RANGE подтипа VT_R4. |
| wiasSetValidRangeLong | Задает диапазон допустимых значений для свойства WIA_PROP_RANGE подтипа VT_I4. |
| wiasUpdateValidFormat | Обновления допустимый формат контекста свойства для текущего мини-драйвера. |
| wiasValidateItemProperties | Проверяет список свойств простых элементов на соответствие их текущим допустимым значениям. |
| wiasWriteMultiple | Записывает несколько значений свойств в элемент WIA (свойства могут быть разных типов). |
| wiasWritePropBin | Записывает одно двоичное значение свойства в элемент WIA. |
| wiasWritePropFloat | Записывает значение свойства с плавающей запятой в элемент WIA. |
| wiasWritePropGuid | Записывает значение свойства GUID в элемент WIA. |
| wiasWritePropLong | Записывает длинное целочисленное значение свойства в элемент WIA. |
| wiasWritePropStr | Записывает строковое значение свойства в элемент WIA. |
Обновление и передача данных
| Функция | Описание |
|---|---|
| wiasDownSampleBuffer | Принимает буфер пиксельных данных и понижает его до указанного размера. |
| wiasGetImageInformation | Извлекает сведения о контексте передачи из элемента. |
| wiasParseEndorserString | Анализирует строку индоссывателя, заменяя определяемые службой и поставщиком токены WIA в строке значениями, связанными с токенами. |
| wiasSendEndOfPage | Вызывает подпрограмму обратного вызова клиента во время передачи данных, отправляя текущее общее число страниц. |
| wiasUpdateScanRect | Обновления размеров области сканирования устройства сканирования. |
| wiasWriteBufToFile | Записывает содержимое временного буфера страницы в файл изображения. |
| wiasWritePageBufToFile | Записывает содержимое временного буфера страницы в файл изображения. Используйте эту функцию для записи страницы в многостраничный TIFF-файл. |