Método IWiaPreview::D etectRegions
Invoca o filtro de segmentação de driver e passa a imagem não filtrada armazenada em cache pelo método IWiaPreview::GetNewPreview para o filtro.
Sintaxe
HRESULT DetectRegions(
[in] LONG lFlags
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Não usado. Defina como zero (0).
Valor retornado
Tipo: HRESULT
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
A operação teve êxito. |
|
O driver não dá suporte à segmentação. |
|
Um código de erro COM padrão. |
Comentários
Um aplicativo deve chamar IWiaPreview::GetNewPreview antes de chamar essa função.
Quando o Componente de Versão Prévia da Aquisição de Imagens do Windows (WIA) 2.0 chama IWiaPreview::D etectRegions, ele invoca o filtro de segmentação de driver e passa a interface IWiaItem2 que foi passada anteriormente para IWiaPreview::GetNewPreview. Ele também passa a imagem armazenada em cache internamente para o filtro. O filtro de segmentação usa a imagem armazenada em cache para criar as extensões filho.
Se um aplicativo alterar as propriedades da interface IWiaItem2 depois de chamar IWiaPreview::GetNewPreview, as propriedades originais deverão ser restauradas antes que o aplicativo chame IWiaPreview::D etectRegions. Use GetPropertyStream e SetPropertyStream para restaurar as propriedades originais.
IWiaPreview::D etectRegions é usado para determinar as "sub-regiões" da imagem armazenada em cache. Para cada sub-região detectada, um novo item wia 2.0 filho é criado na interface IWiaItem2 . Para cada item filho, o filtro de segmentação deve definir os valores para as seguintes propriedades wia 2.0: WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT. Um filtro mais avançado define outras propriedades do WIA 2.0, como WIA_IPS_DESKEW_X e WIA_IPS_DESKEW_Y, se o driver der suporte à desanexação. As propriedades WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT representam o retângulo delimitador da área a ser verificada.
O driver pode não dar suporte à segmentação. Antes de chamar IWiaPreview::D etectRegions, um aplicativo normalmente verifica se o driver dá suporte à propriedade WIA_IPS_SEGMENTATION. Se a propriedade não for implementada, a segmentação não terá suporte e IWiaPreview::D etectRegions falhará e retornará E_NOTIMPL.
O aplicativo deve limpo os itens filho criados chamando IWiaPreview::D etectRegions. Por exemplo, se um aplicativo fizer uma chamada adicional para IWiaPreview::D etectRegions no mesmo item, ele deverá limpo os itens filho anteriores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|