CreateAudioMediaType, fonction

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La fonction CreateAudioMediaType initialise un type de média à partir d’une structure WAVEFORMATEX .

Syntaxe

HRESULT STDAPI CreateAudioMediaType(
   const WAVEFORMATEX  *pwfx,
         AM_MEDIA_TYPE *pmt,
         BOOL          bSetFormat
);

Paramètres

pwfx

Pointeur vers la structure WAVEFORMATEX fournie.

Pmt

Pointeur vers la structure AM_MEDIA_TYPE à initialiser.

bSetFormat

Indicateur indiquant s’il faut initialiser le bloc de format. Spécifiez TRUE pour l’initialiser, ou FALSE dans le cas contraire.

Valeur renvoyée

Retourne E_OUTOFMEMORY si la mémoire n’a pas pu être allouée aux données de format ; S_OK autrement.

Notes

Si le paramètre bSetFormat a la valeur TRUE, la méthode alloue la mémoire pour le bloc de format. Si le paramètre pmt contient déjà un bloc de format alloué, une fuite de mémoire se produit. Pour éviter une fuite de mémoire, appelez FreeMediaType avant d’appeler cette fonction. Une fois la méthode retournée, appelez à nouveau FreeMediaType pour libérer le bloc de format.

Configuration requise

Condition requise Valeur
En-tête
Mtype.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

Fonctions de type de média