Función MFCalculateBitmapImageSize (mfapi.h)

  • Artículo

Recupera el tamaño de la imagen para un formato de vídeo. Dada una estructura BITMAPINFOHEADER , esta función calcula el valor correcto del miembro biSizeImage .

Sintaxis

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

Parámetros

[in] pBMIH

Puntero a una estructura BITMAPINFOHEADER que describe el formato.

[in] cbBufSize

Tamaño del búfer pBMIH , en bytes. El tamaño incluye cualquier máscara de color o entradas de paleta que sigan la estructura BITMAPINFOHEADER .

[out] pcbImageSize

Recibe el tamaño de la imagen, en bytes.

[out] pbKnown

Recibe el valor TRUE si la función reconoce el formato de vídeo. De lo contrario, recibe el valor FALSE. Este parámetro puede ser NULL.

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 La función se ha realizado correctamente.
E_INVALIDARG
 La estructura BITMAPINFOHEADER no es válida o el valor de cbBufSize es demasiado pequeño.

Comentarios

Antes de llamar a esta función, debe establecer al menos los siguientes miembros de la estructura BITMAPINFOHEADER :

  • biCompression
  • biBitCount
  • biWidth
  • biHeight
Además, si biCompression es BI_BITFIELDS, la estructura BITMAPINFOHEADER debe estar seguida de una matriz de máscaras de color.

Esta función produce un error si la estructura BITMAPINFOHEADER describe un formato que no es un formato de vídeo. Por ejemplo, se produce un error si biCompresson es BI_JPEG o BI_PNG .

Esta función está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalado.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfapi.h
Library Mfplat.lib
Archivo DLL Mfplat.dll

Consulte también

Funciones de Media Foundation