Método IGetFrame::SetFormat (vfw.h)

O método SetFormat define o formato de imagem descompactado dos quadros que estão sendo extraídos e, opcionalmente, fornece um buffer para a operação de descompactação.

Sintaxe

HRESULT SetFormat(
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                x,
  int                y,
  int                dx,
  int                dy
);

Parâmetros

lpbi

Ponteiro para uma estrutura BITMAPINFOHEADER definindo o formato de imagem descompactado. Você também pode especificar NULL ou o valor ((LPBITMAPINFOHEADER) 1) para esse parâmetro. NULL faz com que o descompactador escolha um formato apropriado para edição (normalmente um formato de profundidade de imagem de 24 bits). O valor ((LPBITMAPINFOHEADER) 1) faz com que o descompactador escolha um formato apropriado para o modo de exibição atual.

lpBits

Ponteiro para um buffer para conter os dados de imagem descompactados. Especifique NULL para que esse método aloque um buffer.

x

A coordenada x do retângulo de destino dentro do DIB especificado por lpbi. Esse parâmetro é usado quando lpBits não é NULL.

y

A coordenada y do retângulo de destino dentro do DIB especificado por lpbi. Esse parâmetro é usado quando lpBits não é NULL.

dx

Largura do retângulo de destino. Esse parâmetro é usado quando lpBits não é NULL.

dy

Altura do retângulo de destino. Esse parâmetro é usado quando lpBits não é NULL.

Valor retornado

Retorna NOERROR se tiver êxito, E_OUTOFMEMORY se a imagem descompactada for maior que o tamanho do buffer ou E_FAIL caso contrário.

Comentários

Os parâmetros x, y, dx e dy identificam a parte do bitmap especificada por lpbi e lpBits que recebe a imagem descompactada.

Para manipuladores escritos em C++, SetFormat tem a seguinte sintaxe:

HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x, 
    int y, int dx, int dy); 
 

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vfw.h
Biblioteca	Vfw32.lib

Confira também

Interfaces de manipulador de fluxo e arquivos personalizados

Manipuladores de arquivos e fluxo personalizados