Fonction MFCreateMediaBufferFromMediaType (mfapi.h)

Alloue une mémoire tampon système optimale pour un type de média spécifié.

Syntaxe

HRESULT MFCreateMediaBufferFromMediaType(
  [in]  IMFMediaType   *pMediaType,
  [in]  LONGLONG       llDuration,
  [in]  DWORD          dwMinLength,
  [in]  DWORD          dwMinAlignment,
  [out] IMFMediaBuffer **ppBuffer
);

Paramètres

[in] pMediaType

Pointeur vers l’interface IMFMediaType du type de média.

[in] llDuration

Durée de l’exemple. Cette valeur est requise pour les formats audio.

[in] dwMinLength

Taille minimale de la mémoire tampon, en octets. La taille réelle de la mémoire tampon peut être plus grande. Spécifiez zéro pour allouer la taille de mémoire tampon par défaut pour le type de média.

[in] dwMinAlignment

Alignement de mémoire minimal pour la mémoire tampon. Spécifiez zéro pour utiliser l’alignement de la mémoire par défaut.

[out] ppBuffer

Reçoit un pointeur vers l’interface IMFMediaBuffer . L’appelant doit libérer l’interface.

Valeur retournée

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

Notes

Pour les formats vidéo, si le format est reconnu, la fonction crée une mémoire tampon 2D qui implémente l’interface IMF2DBuffer2 . Sinon, il crée une mémoire tampon linéaire. Pour obtenir l’interface IMF2DBuffer2 , appelez QueryInterface sur le pointeur retourné dans ppBuffer. Si la méthode QueryInterface échoue, utilisez l’interface IMFMediaBuffer pour accéder à la mémoire tampon.

Pour les formats audio, la fonction alloue une mémoire tampon suffisamment grande pour contenir des exemples audio llDuration , ou dwMinLength, selon la taille la plus grande.

Cette fonction alloue toujours de la mémoire système. Pour les surfaces Direct3D, utilisez la fonction MFCreateDXGISurfaceBuffer ou MFCreateDXSurfaceBuffer .

Configuration requise

Voir aussi

Fonctions Media Foundation