Metodo IMFSourceReader::Flush (mfreadwrite.h)

Scarica uno o più flussi.

Sintassi

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Parametri

[in] dwStreamIndex

Flusso da scaricare. Il valore può essere uno dei seguenti.

Value	Meaning
0-0xFFFFFFFB	Indice in base zero di un flusso.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Primo flusso video.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Primo flusso audio.
MF_SOURCE_READER_ALL_STREAMS 0xFFFFFFFE	Tutti i flussi.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni:

Il metodo Flush elimina tutti gli esempi in coda e annulla tutte le richieste di esempio in sospeso.

Questo metodo può essere completato in modo sincrono o asincrono.

Se si specifica un puntatore di callback quando si crea il lettore di origine, il metodo è asincrono. In caso contrario, il metodo è sincrono. Per altre informazioni sull'impostazione del puntatore di callback, vedere MF_SOURCE_READER_ASYNC_CALLBACK.

In modalità sincrona, il metodo si blocca fino al completamento dell'operazione.

In modalità asincrona, il metodo IMFSourceReaderCallback::OnFlush dell'applicazione viene chiamato al termine dell'operazione di scaricamento. Mentre un'operazione di scaricamento è in sospeso, il metodo IMFSourceReader::ReadSample restituisce MF_E_NOTACCEPTING.

Nota In Windows 7 si è verificato un bug nell'implementazione di questo metodo, che fa sì che OnFlush venga chiamato prima del completamento dell'operazione di scaricamento. Hotfix usato per essere disponibile che ha corretto il bug.

 

Questa interfaccia è disponibile in Windows Vista se è installato il supplemento di aggiornamento della piattaforma per Windows Vista.

Requisiti

Requisito	Value
Client minimo supportato	Supplemento per Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Header	mfreadwrite.h

Vedere anche

IMFSourceReader

Lettore di origine