IAsyncReader-Schnittstelle (strmif.h)
Die IAsyncReader Schnittstelle führt eine asynchrone Datenanforderung für einen Filter aus.
Diese Schnittstelle wird von Ausgabeheften verfügbar gemacht, die asynchrone Lesevorgänge ausführen. Die Schnittstelle wird vom Eingabeheft auf dem nachgeschalteten Filter verwendet. Anwendungen verwenden diese Schnittstelle nicht. Der Async File Source-Filter macht diese Schnittstelle auf seinem Ausgabeheft verfügbar.
Filterentwickler: Implementieren Sie diese Schnittstelle, wenn Ihre Ausgabehefte Daten in Form eines Bytestreams (MEDIATYPE_Stream) bereitstellt und das Pullmodell unterstützt. Überprüfen Sie während des Verbindungsvorgangs, ob die nachgelagerten Pin-Abfragen für die IAsyncReader Schnittstelle ausgeführt werden. Wenn dies nicht der Fall ist, sollte ihre Pin entweder die Verbindung fehlschlagen oder einen anderen Transport herstellen. (Wenn Ihre Pin von CBasePin abgeleitet ist, führen Sie diese Überprüfung in der CBasePin::CheckConnect-Methode aus.)
Weitere Informationen zur Verwendung dieser Schnittstelle finden Sie in den folgenden Themen:
Vererbung
Die IAsyncReader-Schnittstelle erbt von der IUnknown-Schnittstelle . IAsyncReader verfügt auch über diese Arten von Mitgliedern:
Methoden
Die IAsyncReader-Schnittstelle verfügt über diese Methoden.
| IAsyncReader::BeginFlush Die BeginFlush-Methode beginnt einen Spülvorgang. (IAsyncReader.BeginFlush) |
| IAsyncReader::EndFlush Die EndFlush-Methode beendet einen Spülvorgang. (IAsyncReader.EndFlush) |
| IAsyncReader::Length Die Length-Methode ruft die Gesamtlänge des Datenstroms ab. |
| IAsyncReader::Request Die Request-Methode stellt eine asynchrone Anforderung für Daten in die Warteschlange. |
| IAsyncReader::RequestAllocator Die RequestAllocator-Methode fordert während der Pinverbindung einen Allocator an. |
| IAsyncReader::SyncRead Die SyncRead-Methode führt einen synchronen Lesevorgang aus. Die Methode blockiert, bis die Anforderung abgeschlossen ist. Die Dateipositionen und die Pufferadresse müssen nicht ausgerichtet werden. Wenn die Anforderung nicht ausgerichtet ist, führt die Methode einen pufferten Lesevorgang aus. |
| IAsyncReader::SyncReadAligned Die SyncReadAligned-Methode führt einen synchronen Lesevorgang aus. Die Methode blockiert, bis die Anforderung abgeschlossen ist. Die Dateipositionen und die Pufferadresse müssen ausgerichtet werden; überprüfen Sie die Allocatoreigenschaften für die erforderliche Ausrichtung. |
| IAsyncReader::WaitForNext Die WaitForNext-Methode wartet auf die nächste ausstehende Leseanforderung, bis sie abgeschlossen ist. |
Anforderungen
| 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) |