Partager via


IMFSourceReader ::Flush, méthode (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 valeurs suivantes.

Valeur Meaning
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 HRESULT code d’erreur.

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 s’effectuer 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 lorsque l’opération de vidage se termine. Pendant qu’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 entraîne l’appel d’OnFlush avant la fin de l’opération de vidage. Correctif logiciel utilisé pour être disponible qui a corrigé ce bogue.
 
Cette interface est disponible sur Windows Vista si le supplément de mise à jour de plateforme pour Windows Vista est installé.

Spécifications

Requirement Valeur
Client minimum requis Supplément Windows 7, Windows Vista et Mise à jour de 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 Fenêtres
Header mfreadwrite.h

Voir aussi

IMFSourceReader

Lecteur source