Método IWiaSegmentationFilter::D etectRegions (wia_lh.h)
El método IWiaSegmentationFilter::D etectRegions determina las subregiones de una imagen colocada en la placa plana para que cada subregió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 usa. Debe establecerse como 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.
Comentarios
Este método determina las subregiones de la imagen representada por pInputStream. Para cada subregió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 analizador WIA:
Un filtro más avanzado también podría requerir otras propiedades del 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 e IWiaPropertyStorage::SetPropertyStream.
La aplicación debe restablecer la versión preliminar de IStream 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 | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wia_lh.h (incluya Wia_lh.h) |