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:
| C++ |
|---|
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |