IWiaPreview::D etectRegions (método)
Invoca el filtro de segmentación de controladores y pasa la imagen sin filtrar almacenada en caché por el método IWiaPreview::GetNewPreview al filtro.
Sintaxis
HRESULT DetectRegions(
[in] LONG lFlags
);
Parámetros
-
lFlags [in]
-
Tipo: LONG
No se usa. Establezca en cero (0).
Valor devuelto
Tipo: HRESULT
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
El controlador no admite la segmentación. |
|
Código de error COM estándar. |
Comentarios
Una aplicación debe llamar a IWiaPreview::GetNewPreview antes de llamar a esta función.
Cuando el componente de versión preliminar de Windows Image Acquisition (WIA) 2.0 llama a IWiaPreview::D etectRegions, invoca el filtro de segmentación de controladores y pasa la interfaz IWiaItem2 que se pasó anteriormente a IWiaPreview::GetNewPreview. También pasa la imagen almacenada internamente en caché al filtro. El filtro de segmentación usa la imagen almacenada en caché para crear las extensiones secundarias.
Si una aplicación cambia las propiedades de la interfaz IWiaItem2 después de llamar a IWiaPreview::GetNewPreview, las propiedades originales se deben restaurar antes de que la aplicación llame a IWiaPreview::D etectRegions. Use GetPropertyStream y SetPropertyStream para restaurar las propiedades originales.
IWiaPreview::D etectRegions se usa para determinar las "subregiones" de la imagen almacenada en caché. Para cada subregión detectada, se crea un nuevo elemento WIA 2.0 secundario en la interfaz IWiaItem2 . Para cada elemento secundario, el filtro de segmentación debe establecer los valores de las siguientes propiedades de WIA 2.0: WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT y WIA_IPS_YEXTENT. Un filtro más avanzado establece otras propiedades de WIA 2.0, como WIA_IPS_DESKEW_X y WIA_IPS_DESKEW_Y, si el controlador admite desfase. Las propiedades WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT y WIA_IPS_YEXTENT representan el rectángulo delimitador del área que se va a examinar.
Es posible que el controlador no admita la segmentación. Antes de llamar a IWiaPreview::D etectRegions, una aplicación normalmente comprueba si el controlador admite la propiedad WIA_IPS_SEGMENTATION. Si la propiedad no se implementa, no se admite la segmentación y IWiaPreview::D etectRegions produce un error y devuelve E_NOTIMPL.
La aplicación debe limpiar los elementos secundarios creados mediante una llamada a IWiaPreview::D etectRegions. Por ejemplo, si una aplicación realiza una llamada adicional a IWiaPreview::D etectRegions en el mismo elemento, debe limpiar los elementos secundarios anteriores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| IDL |
|