Método IWiaSegmentationFilter::D etectRegions (wia_lh.h)
El método IWiaSegmentationFilter::D etectRegions determina las subredes de una imagen dispuestas en el platen plano para que cada subdivisión se pueda adquirir en un elemento de imagen independiente.
Sintaxis
HRESULT DetectRegions(
[in] LONG lFlags,
[in, optional] IStream *pInputStream,
[in, optional] IWiaItem2 *pWiaItem2
);
Parámetros
[in] lFlags
Actualmente no se está usando. Debe establecerse en cero.
[in, optional] pInputStream
Especifica un puntero a la imagen de vista previa de IStream.
[in, optional] pWiaItem2
Especifica un puntero al elemento IWiaItem2 para el que se adquirió pInputStream. El filtro de segmentación crea elementos secundarios para este elemento.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente o un valor de error COM estándar de lo contrario.
Observaciones
Este método determina las subdivisiones de la imagen representadas por pInputStream. Para cada subdivisión que detecta, crea un elemento secundario para el elemento IWiaItem2] al que apunta el parámetro pWiaItem2. Para cada elemento secundario, el filtro de segmentación debe establecer valores para el rectángulo delimitador del área que se va a examinar mediante las siguientes propiedades del elemento del escáner WIA:
Un filtro más avanzado también puede requerir otras propiedades de elemento del escáner, como WIA_IPS_DESKEW_X y WIA_IPS_DESKEW_Y, si el controlador admite deskewing.
Si una aplicación llama a IWiaSegmentationFilter::D etectRegions más de una vez, la aplicación debe eliminar primero los elementos secundarios creados por la última llamada al método IWiaSegmentationFilter::D etectRegions.
Si una aplicación cambia las propiedades en pWiaItem2, entre adquirir la imagen en pInputStream y su llamada a IWiaSegmentationFilter::D etectRegions, se debe restaurar la configuración de la propiedad original (la configuración de propiedad que tenía el elemento cuando se adquirió la secuencia). Esto se puede hacer mediante IWiaPropertyStorage::GetPropertyStream y IWiaPropertyStorage::SetPropertyStream.
La aplicación debe restablecer el IStream versión preliminar si su llamada pasa la misma secuencia al filtro de segmentación más de una vez. La aplicación también debe restablecer la secuencia después de la descarga inicial y antes de llamar a IWiaSegmentationFilter::D etectRegions.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wia_lh.h (incluya Wia_lh.h) |