Metodo IMFSourceReader::Flush (mfreadwrite.h)

  • Articolo

Scarica uno o più flussi.

Sintassi

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Parametri

[in] dwStreamIndex

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

Valore Significato
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
 Il 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 .

Commenti

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

Questo metodo può completare 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 blocca fino al completamento dell'operazione.

In modalità asincrona viene chiamato il metodo FMSourceReaderCallback::OnFlush 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 causa la chiamata a OnFlush prima del completamento dell'operazione di scaricamento. Hotfix usato per essere disponibile per risolvere il bug.
 
Questa interfaccia è disponibile in Windows Vista se è installato l'aggiornamento della piattaforma per Windows Vista.

Requisiti

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

Vedi anche

IMFSourceReader

Lettore di origine