CreateAudioMediaType, fonction
[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 |
|
Bibliothèque |
|