Partager via


Méthode CTransformOutputPin.CheckMediaType

[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 CheckMediaType méthode détermine si l’épingle accepte un type de média spécifique.

Syntaxe

HRESULT CheckMediaType(
   const CMediaType *mtIn
);

Paramètres

mtIn

Pointeur vers un objet CMediaType qui contient le type de média proposé.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
S_OK
Opération réussie.
E_INVALIDARG
La broche d’entrée du filtre n’est pas connectée.

Notes

Cette méthode implémente la méthode CBasePin::CheckMediaType virtuelle pure. La méthode échoue si la broche d’entrée du filtre n’est pas connectée. Sinon, elle appelle la méthode CTransformFilter::CheckTransform du filtre, qui est également virtuelle pure. La classe dérivée du filtre doit implémenter CheckTransform, qui détermine si le type de média de sortie proposé est compatible avec le type de média d’entrée.

Configuration requise

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