Méthode IPin ::BeginFlush (strmif.h)
[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 BeginFlush méthode commence une opération de vidage.
Les applications ne doivent pas appeler cette méthode. Cette méthode est appelée par d’autres filtres pour vider les données du graphique.
Syntaxe
HRESULT BeginFlush();
Valeur de retour
Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Réussite. |
|
La broche est une broche de sortie. |
Remarques
Appelez cette méthode uniquement sur les broches d’entrée. Les broches de sortie retournent E_UNEXPECTED.
Dans une opération de vidage, un filtre ignore les données qu’il a traitées. Il rejette les nouvelles données jusqu’à ce que le vidage soit terminé. Le vidage est terminé lorsque l’épingle amont appelle la méthode IPin ::EndFlush. Le vidage permet au graphique de filtre d’être plus réactif lorsque des événements modifient le flux de données normal. Par exemple, le vidage se produit pendant une recherche.
Quand BeginFlush est appelé, le filtre effectue les étapes suivantes :
- Passe l’appel
IPin::BeginFlushen aval. - Définit un indicateur interne qui provoque l’échec de toutes les méthodes de diffusion en continu de données, telles que IMemInputPin ::Receive.
- Retourne à partir de tous les appels bloqués à la méthode Receive .
BeginFlush notification atteint un filtre de renderer, le convertisseur libère tous les échantillons qu’il contient.
Une BeginFlush fois appelé, l’épingle rejette tous les échantillons de amont, avec une valeur de retour S_FALSE, jusqu’à ce que la méthode IPin ::EndFlush soit appelée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |