Méthode CTransformInputPin.Receive

[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 Receive méthode reçoit l’exemple multimédia suivant dans le flux. Cette méthode implémente la méthode IMemInputPin::Receive .

Syntaxe

HRESULT Receive(
   IMediaSample *pSample
);

Paramètres

pSample

Pointeur vers l’interface IMediaSample de l’exemple.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Notes

Cette méthode appelle la méthode CBaseInputPin::Receive de la broche, qui vérifie l’état de diffusion en continu de la broche et recherche les modifications de format dans le type de média. Ensuite, il appelle la méthode CTransformFilter::Receive du filtre, qui traite l’exemple et le remet en aval.

Si le filtre doit accéder à l’exemple après le retour de cette méthode, il doit contenir un nombre de références en appelant la méthode IUnknown::AddRef sur l’exemple. Par exemple, certains filtres de décodeur ont besoin de l’exemple actuel pour décoder l’exemple suivant.

Configuration requise