Поделиться через

Добавление свойств WIA к элементу WIA

  • Статья

Каждый элемент WIA содержит свойства WIA. Приложение считывает и записывает свойства элементов WIA для настройки мини-драйвера WIA. Служба WIA вызывает метод IWiaMiniDrv::d rvInitItemProperties один раз для каждого элемента, к которому обращается приложение, для инициализации свойств этого элемента minidriver WIA. Если приложение не считывает и не записывает свойства WIA для элемента, этот метод не вызывается для этого элемента. Контекст элемента, на который указывает параметр pWiasContext , указывает, какой элемент будет инициализирован со свойствами WIA.

Метод IWiaMiniDrv::d rvInitItemProperties должен выполнять следующие задачи:

  1. Используйте данные, полученные в параметре pWiasContext , чтобы определить тип элемента. Мини-накопитель WIA может получить COM-интерфейс IWiaDrvItem , вызвав wiasGetDrvItem. После получения этого интерфейса можно вызвать метод IWiaDrvItem::GetItemFlags для определения типа элемента WIA.

  2. Создайте массив имен свойств и идентификаторов свойств, описывающих полный набор свойств, необходимый для текущего элемента. После создания этих массивов мини-накопитель WIA должен вызвать функцию службы wiasSetItemPropNames . Эта функция указывает службе WIA создать набор свойств WIA на основе созданных массивов. Эта функция всегда должна вызываться перед wiasWriteMultiple и wiasSetItemPropAttribs.

  3. Запишите начальные значения или значения по умолчанию в только что созданный набор свойств WIA. Мини-диск WIA должен вызывать функцию службы wiasWriteMultiple , чтобы задать начальные значения. Эта функция всегда должна вызываться перед wiasSetItemPropAttribs.

  4. Запишите допустимые значения и права доступа для каждого свойства. Мини-накопитель WIA должен вызвать функцию службы wiasSetItemPropAttribs , чтобы задать права доступа и допустимые значения.

Приложения отвечают за чтение (и повторное чтение) всех свойств, от которых они зависят, тем самым позволяя приложению перехватывать любые изменения в значениях свойств. Сканеры и камеры имеют набор обязательных свойств. Эти свойства перечислены в разделе Сведения о свойствах WIA.

Некоторые свойства зависят от других свойств. Например, свойство format зависит от свойства tymed . Эти зависимости между свойствами рассматриваются в разделе Свойства WIA.