Partager via


Méthode CMediaType.SetFormat

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 SetFormat méthode initialise le bloc de format.

Syntaxe

BOOL SetFormat(
   BYTE  *pFormat,
   ULONG length
);

Paramètres

pFormat

Pointeur vers un bloc de mémoire qui contient le bloc de format.

length

Longueur du bloc de format, en octets.

Valeur renvoyée

Retourne TRUE si elle réussit ou FALSE si une erreur s’est produite.

Notes

Cette méthode alloue de la mémoire pour le bloc de format et copie la mémoire tampon spécifiée par pFormat dans le nouveau bloc de format. Si le type de média contient déjà un bloc de format, l’ancien est libéré. La méthode définit également le membre cbFormat de la structure AM_MEDIA_TYPE .

Pour définir le type de format, appelez la méthode CMediaType::SetFormatType .

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

CMediaType, classe