Método IWiaSegmentationFilter::D etectRegions (wia_lh.h)
O método IWiaSegmentationFilter::D etectRegions determina as sub-regiões de uma imagem disposta no flatbed platen para que cada sub-região possa ser adquirida em um item de imagem separado.
Sintaxe
HRESULT DetectRegions(
[in] LONG lFlags,
[in, optional] IStream *pInputStream,
[in, optional] IWiaItem2 *pWiaItem2
);
Parâmetros
[in] lFlags
Atualmente não utilizado. Deve ser definido como zero.
[in, optional] pInputStream
Especifica um ponteiro para a imagem de visualização do IStream.
[in, optional] pWiaItem2
Especifica um ponteiro para o item deIWiaItem2 para o qual pInputStream foi adquirido. O filtro de segmentação cria itens filho para este item.
Valor de retorno
Retorna S_OK se tiver êxito ou um valor de erro COM padrão, caso contrário.
Observações
Esse método determina as sub-regiões da imagem representada por pInputStream. Para cada sub-região detectada, ele cria um item filho para o item IWiaItem2] apontado pelo parâmetro pWiaItem2. Para cada item filho, o filtro de segmentação deve definir valores para o retângulo delimitador da área a ser verificado, usando as seguintes propriedades de item de scanner WIA:
Um filtro mais avançado também pode exigir outras propriedades de item de scanner, como WIA_IPS_DESKEW_X e WIA_IPS_DESKEW_Y, se o driver der suporte ao deskewing.
Se um aplicativo chamar IWiaSegmentationFilter::D etectRegions mais de uma vez, o aplicativo deverá primeiro excluir os itens filho criados pela última chamada para o método IWiaSegmentationFilter::D etectRegions.
Se um aplicativo alterar as propriedades em pWiaItem2, entre adquirir a imagem em pInputStream e sua chamada para IWiaSegmentationFilter::D etectRegions, as configurações de propriedade original (as configurações de propriedade que o item tinha quando o fluxo foi adquirido) deverão ser restauradas. Isso pode ser feito usando IWiaPropertyStorage::GetPropertyStream e IWiaPropertyStorage::SetPropertyStream.
O aplicativo deve redefinir o IStream visualização se sua chamada passar o mesmo fluxo para o filtro de segmentação mais de uma vez. O aplicativo também deve redefinir o fluxo após o download inicial e antes de chamar IWiaSegmentationFilter::D etectRegions.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wia_lh.h (inclua Wia_lh.h) |