KsStreamPointerAdvance-Funktion (ks.h)
Die KsStreamPointerAdvance-Funktion führt einen Streamzeiger auf den nächsten Datenrahmen aus.
Syntax
KSDDKAPI NTSTATUS KsStreamPointerAdvance(
[in] PKSSTREAM_POINTER StreamPointer
);
Parameter
[in] StreamPointer
Ein Zeiger auf eine KSSTREAM_POINTER Struktur, die den Datenstromzeiger darstellt, um auf den nächsten verfügbaren Datenrahmen zu verweisen.
Rückgabewert
KsStreamPointerAdvance gibt STATUS_SUCCESS zurück, um eine erfolgreiche Weiterentwicklung anzuzeigen. Andernfalls wird ein Fehlercode zurückgegeben. STATUS_DEVICE_NOT_READY ist der am häufigsten zurückgegebene Fehlercode und weist häufig darauf hin, dass beim Sperren des Streamzeigers nach der Weiterentwicklung ein Fehler aufgetreten ist. Mit anderen Worten: StreamPointer verweist auf den letzten Frame in der Warteschlange.
Hinweise
Wenn StreamPointer zur Anrufzeit gesperrt ist, entsperrt AVStream ihn, bevor er voranschreitet. Nach dem Erweiterten wird der Streamzeiger wieder in den ursprünglichen Zustand (gesperrt oder entsperrt) im neuen Frame versetzt.
Ein Versuch, einen datenstromzeigeren, entsperrten Datenstromzeiger voranzutreiben, ist immer erfolgreich und gibt STATUS_SUCCESS zurück. Da der Streamzeiger nicht gesperrt ist, kann nicht ermittelt werden, ob der Streamzeiger auf tatsächliche Daten verweist. Der Minidriver muss eine Sperre versuchen, um festzustellen, ob der neu erweiterte Streamzeiger auf einen Datenrahmen verweist oder nicht.
Siehe auch Stream Zeiger.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |