Méthode CBaseRenderer. PrepareReceive

La PrepareReceive méthode prépare le filtre pour restituer un exemple.

Syntaxe

virtual HRESULT PrepareReceive(
   IMediaSample *pMediaSample
);

Paramètres

pMediaSample

Pointeur vers l’interface IMediaSample de l’exemple.

Valeur de retour

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

Code de retour Description
_OK
Réussite.
E _ échec
Échec.
E _ inattendu
Erreur inattendue.
exemple de VFW _ E _ _ rejeté
Le filtre supprime cet exemple.

Notes

Le filtre appelle cette méthode à l’intérieur de la méthode CBaseRenderer :: Receive , avant d’afficher un exemple. Si le filtre est en cours d’exécution, cette méthode planifie l’exemple de rendu.

Si le filtre a déjà un échantillon en attente, ou si la fin du flux a déjà été atteinte, la méthode retourne E _ inattendue. Le filtre en amont ne sérialise peut-être pas correctement ses appels de diffusion en continu.

Si l’algorithme de planification détermine que l’exemple doit être supprimé (voir CBaseRenderer :: ScheduleSample), la méthode retourne un échantillon de VFW _ E _ _ rejeté. Toutefois, la méthode IMemInputPin :: Receive de la broche d’entrée ne transmet pas ce code d’erreur au filtre en amont, car la suppression d’un exemple n’est pas une erreur.

Spécifications

Condition requise Valeur
En-tête
Renbase. h (inclure Flux. h)
Bibliothèque
Strmbase. lib (versions commerciales);
Strmbasd. lib (versions Debug)

Voir aussi

CBaseRenderer, classe