Fonction MFGetStrideForBitmapInfoHeader (mfapi.h)

Article
08/24/2023

Calcule la foulée de surface minimale pour un format vidéo.

Syntaxe

HRESULT MFGetStrideForBitmapInfoHeader(
  [in]  DWORD format,
  [in]  DWORD dwWidth,
  [out] LONG  *pStride
);

Paramètres

[in] format

Le code FOURCC ou D3DFORMAT valeur qui spécifie le format vidéo. Si vous avez un GUID de sous-type vidéo, vous pouvez utiliser le premier DWORD du sous-type.

[in] dwWidth

Largeur de l’image, en pixels.

[out] pStride

Reçoit la foulée de surface minimale, en pixels.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Cette fonction calcule la foulée minimale nécessaire pour conserver l’image en mémoire. Utilisez cette fonction si vous allouez des mémoires tampons dans la mémoire système. Les surfaces allouées en mémoire vidéo peuvent nécessiter une progression plus importante, en fonction des graphiques carte.

Si vous utilisez une mémoire tampon de surface DirectX, utilisez la méthode IMF2DBuffer::Lock2D pour rechercher la foulée de surface.

Pour les formats YUV planaires, cette fonction retourne la foulée du plan Y. Selon le format, les plans de chroma peuvent avoir une foulée différente.

Note Avant Windows 7, cette fonction était exportée à partir de evr.dll. À partir de Windows 7, cette fonction est exportée à partir de mfplat.dll et evr.dll exporte une fonction stub qui appelle dans mfplat.dll. Pour plus d’informations, consultez Modifications de bibliothèque dans Windows 7.

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	Evr.lib
DLL	Mfplat.dll

Voir aussi

Stride d’image

Fonctions Media Foundation

Partager via