IAsyncReader::BeginFlush-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die BeginFlush -Methode beginnt einen Leerungsvorgang.

Syntax

HRESULT BeginFlush();

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, oder S_FALSE andernfalls.

Hinweise

Diese Methode unterbricht alle ausstehenden Leseanforderungen. Während die Pin geleert wird, schlägt die IAsyncReader::Request-Methode fehl, und die IAsyncReader::WaitForNext-Methode gibt sofort zurück, möglicherweise mit dem Rückgabecode VFW_E_TIMEOUT.

Der Nachgeschaltete Eingabenadel sollte diese Methode aufrufen, wenn der nachgeschaltete Filter das Filterdiagramm gelemmt. Rufen Sie nach dem Aufrufen dieser Methode die WaitForNext-Methode auf, bis sie NULL im ppSample-Parameter zurückgibt, um die Warteschlange der ausstehenden Beispiele zu löschen. Ignorieren Sie Fehlercodes, und lassen Sie jedes Beispiel los. Rufen Sie dann die IAsyncReader::EndFlush-Methode auf, um den Spülvorgang zu beenden.

Weitere Informationen finden Sie unter Leerung.

Beispiele

Das folgende Beispiel zeigt, wie ein Nachgeschalteter Eingabenadel diese Methode aufrufen soll:

m_pReader->BeginFlush(); 
while (1) {
    IMediaSample *pSample;
    DWORD_PTR dwUnused;
    m_pReader->WaitForNext(0, &pSample, &dwUnused);
    if(pSample) { 
        pSample->Release();  
    } 
    else {  // No more samples.
        break;
    }
}
m_pReader->EndFlush();

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IAsyncReader-Schnittstelle