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
S_OK	A operação teve êxito.
E_NOTIMPL	O driver não dá suporte à segmentação.
Caso contrário	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	Wia.h
IDL	Wia.idl