Share via

Fonction MFCalculateBitmapImageSize (mfapi.h)

  • Article

Récupère la taille de l’image pour un format vidéo. Avec une structure BITMAPINFOHEADER , cette fonction calcule la valeur correcte du membre biSizeImage .

Syntaxe

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

Paramètres

[in] pBMIH

Pointeur vers une structure BITMAPINFOHEADER qui décrit le format.

[in] cbBufSize

Taille de la mémoire tampon pBMIH , en octets. La taille inclut les masques de couleur ou les entrées de palette qui suivent la structure BITMAPINFOHEADER .

[out] pcbImageSize

Reçoit la taille de l’image, en octets.

[out] pbKnown

Reçoit la valeur TRUE si la fonction reconnaît le format vidéo. Sinon, reçoit la valeur FALSE. Ce paramètre peut être NULL.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 La fonction a réussi.
E_INVALIDARG
 La structure BITMAPINFOHEADER n’est pas valide ou la valeur de cbBufSize est trop petite.

Notes

Avant d’appeler cette fonction, vous devez définir au moins les membres suivants de la structure BITMAPINFOHEADER :

  • biCompression
  • biBitCount
  • biWidth
  • biHeight
En outre, si biCompression est BI_BITFIELDS, la structure BITMAPINFOHEADER doit être suivie d’un tableau de masques de couleur.

Cette fonction échoue si la structure BITMAPINFOHEADER décrit un format qui n’est pas un format vidéo. Par exemple, il échoue si biCompresson est BI_JPEG ou BI_PNG .

Cette fonction est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfapi.h
Bibliothèque Mfplat.lib
DLL Mfplat.dll

Voir aussi

Fonctions Media Foundation