Partager via


Méthode IMFSourceReader ::Flush (mfreadwrite.h)

Vide un ou plusieurs flux.

Syntaxe

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Paramètres

[in] dwStreamIndex

Flux à vider. La valeur peut être l’une des suivantes.

Valeur Signification
0 à 0xFFFFFFFB
Index de base zéro d’un flux.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
Premier flux vidéo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
Premier flux audio.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
Tous les flux.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La méthode Flush ignore tous les exemples mis en file d’attente et annule toutes les demandes d’exemples en attente.

Cette méthode peut être effectuée de manière synchrone ou asynchrone.

Si vous fournissez un pointeur de rappel lorsque vous créez le lecteur source, la méthode est asynchrone. Sinon, la méthode est synchrone. Pour plus d’informations sur la définition du pointeur de rappel, consultez MF_SOURCE_READER_ASYNC_CALLBACK.

En mode synchrone, la méthode se bloque jusqu’à ce que l’opération soit terminée.

En mode asynchrone, la méthode IMFSourceReaderCallback ::OnFlush de l’application est appelée une fois l’opération de vidage terminée. Lorsqu’une opération de vidage est en attente, la méthode IMFSourceReader ::ReadSample retourne MF_E_NOTACCEPTING.

Note Dans Windows 7, il y a eu un bogue dans l’implémentation de cette méthode, ce qui provoque l’appel d’OnFlush avant la fin de l’opération de vidage. Un correctif logiciel autrefois disponible qui a résolu ce bogue.
 
Cette interface est disponible sur Windows Vista si le Supplément mise à jour de la plateforme pour Windows Vista est installé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Supplément windows 7, Windows Vista et mise à jour de la plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête mfreadwrite.h

Voir aussi

IMFSourceReader

Lecteur source