Share via

Função MFCalculateBitmapImageSize (mfapi.h)

  • Artigo

Recupera o tamanho da imagem para um formato de vídeo. Dada uma estrutura BITMAPINFOHEADER , essa função calcula o valor correto do membro biSizeImage .

Sintaxe

HRESULT MFCalculateBitmapImageSize(
  [in]  const BITMAPINFOHEADER *pBMIH,
  [in]  UINT32                 cbBufSize,
  [out] UINT32                 *pcbImageSize,
  [out] BOOL                   *pbKnown
);

Parâmetros

[in] pBMIH

Ponteiro para uma estrutura BITMAPINFOHEADER que descreve o formato.

[in] cbBufSize

Tamanho do buffer pBMIH , em bytes. O tamanho inclui quaisquer máscaras de cores ou entradas de paleta que seguem a estrutura BITMAPINFOHEADER .

[out] pcbImageSize

Recebe o tamanho da imagem, em bytes.

[out] pbKnown

Receberá o valor TRUE se a função reconhecer o formato de vídeo. Caso contrário, receberá o valor FALSE. Este parâmetro pode ser NULL.

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 A função foi bem-sucedida.
E_INVALIDARG
 A estrutura BITMAPINFOHEADER não é válida ou o valor de cbBufSize é muito pequeno.

Comentários

Antes de chamar essa função, você deve definir pelo menos os seguintes membros da estrutura BITMAPINFOHEADER :

  • Bicompression
  • Bibitcount
  • Biwidth
  • Biheight
Além disso, se biCompression for BI_BITFIELDS, a estrutura BITMAPINFOHEADER deverá ser seguida por uma matriz de máscaras de cores.

Essa função falhará se a estrutura BITMAPINFOHEADER descrever um formato que não seja um formato de vídeo. Por exemplo, ele falhará se biCompresson for BI_JPEG ou BI_PNG .

Essa função estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

Funções do Media Foundation