Fonction MFCalculateBitmapImageSize (mfapi.h)

Article
08/24/2023

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

Partager via