Метод IWiaSegmentationFilter::D etectRegions (wia_lh.h)

Статья
02/07/2025

Метод IWiaSegmentationFilter::D etectRegions определяет состояния изображения, выложенного на плоской плите, чтобы каждый из них можно было получить в отдельный элемент изображения.

Синтаксис

HRESULT DetectRegions(
  [in]           LONG      lFlags,
  [in, optional] IStream   *pInputStream,
  [in, optional] IWiaItem2 *pWiaItem2
);

Параметры

[in] lFlags

В настоящее время не используется. Должно быть задано равно нулю.

[in, optional] pInputStream

Указывает указатель на образ IStream предварительной версии.

[in, optional] pWiaItem2

Указывает указатель на элемент IWiaItem2, для которого был приобретен pInputStream. Фильтр сегментации создает дочерние элементы для этого элемента.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения или стандартного значения ошибки COM в противном случае.

Замечания

Этот метод определяет значения изображения, представленные pInputStream. Для каждого обнаруженного им элемента создается дочерний элемент для элемента IWiaItem2], на который указывает параметр pWiaItem2. Для каждого дочернего элемента фильтр сегментации должен задать значения для ограничивающего прямоугольника области для сканирования, используя следующие свойства элемента сканера WIA:

Кроме того, для более расширенного фильтра могут потребоваться другие свойства элемента сканера, такие как WIA_IPS_DESKEW_X и WIA_IPS_DESKEW_Y, если драйвер поддерживает рабочий стол.

Если приложение вызывает IWiaSegmentationFilter::D etectRegions несколько раз, приложение должно сначала удалить дочерние элементы, созданные последним вызовом метода IWiaSegmentationFilter::D etectRegions.

Если приложение изменяет все свойства на pWiaItem2, между получением образа в pInputStream и его вызовом IWiaSegmentationFilter::D etectRegions, исходные параметры свойств (параметры свойства, которые элемент имел при получении потока), необходимо восстановить. Это можно сделать с помощью IWiaPropertyStorage::GetPropertyStream и IWiaPropertyStorage::SetPropertyStream.

Приложение должно сбросить IStream предварительной версии, если его вызов передает тот же поток в фильтр сегментации несколько раз. Приложение также должно сбросить поток после начальной загрузки и перед вызовом IWiaSegmentationFilter::D etectRegions.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	wia_lh.h (include Wia_lh.h)

См. также

IStream

IWiaItem2

IWiaPropertyStorage

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