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 |
|---|---|
|
Réussite. |
|
Échec. |
|
Erreur inattendue. |
|
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 |
|
| Bibliothèque |
|