Compartilhar via


Método IWiaImageFilter::FilterPreviewImage

Filtra a imagem de visualização.

Sintaxe

HRESULT FilterPreviewImage(
  [in] LONG      lFlags,
  [in] IWiaItem2 *pWiaChildItem2,
  [in] RECT      InputImageExtents,
  [in] IStream   *pInputStream
);

Parâmetros

lFlags [in]

Tipo: LONG

Não usado. Defina como 0.

pWiaChildItem2 [in]

Tipo: IWiaItem2*

O item que é processado.

InputImageExtents [in]

Tipo: RECT

As coordenadas (na área de aquisição física) da imagem que o componente de visualização armazena em cache internamente.

pInputStream [in]

Tipo: IStream*

Um ponteiro para a interface IStream para os dados de imagem armazenados em cache filtrados.

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Não chame esse método diretamente do seu aplicativo.

pWiaChildItem2 deve ser um item filho do pWiaItem2 que foi passado para IWiaImageFilter::InitializeFilter.

InputImageExtents é necessário porque o filtro de processamento de imagem é responsável por cortar a área de imagem que pWiaChildItem2 representa dos dados de imagem passados por meio de pInputStream.

Um aplicativo deve garantir que pWiaChildItem2 tenha o mesmo formato de imagem (WIA_IPA_FORMAT), resolução (WIA_IPS_XRES e WIA_IPS_YRES) e profundidade de bit (WIA_IPA_DEPTH) que pWiaItem2 tinha quando foi passado para GetNewPreview.

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