KsStreamPointerAdvance-Funktion (ks.h)
Die KsStreamPointerAdvance--Funktion wechselt einen Datenstromzeiger zum nächsten Datenrahmen.
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 einen erfolgreichen Fortschritt anzuzeigen. Andernfalls wird ein Fehlercode zurückgegeben. STATUS_DEVICE_NOT_READY ist der am häufigsten zurückgegebene Fehlercode und gibt häufig an, dass das Sperren des Datenstromzeigers nach der Weiterentwicklung fehlgeschlagen ist. Mit anderen Worten: StreamPointer auf den letzten Frame in der Warteschlange verweist.
Bemerkungen
Wenn StreamPointer- zur Anrufzeit gesperrt ist, entsperrt AVStream sie, bevor sie vorangestellt wird. Sobald der Datenstromzeiger erweitert wurde, wird der Datenstromzeiger wieder in den ursprünglichen Zustand (gesperrt oder entsperrt) im neuen Frame versetzt.
Ein Versuch, einen Datenstromzeiger, der entsperrt ist, immer erfolgreich auszuführen und gibt STATUS_SUCCESS zurück. Da der Datenstromzeiger nicht gesperrt ist, gibt es keine Möglichkeit, festzustellen, ob der Datenstromzeiger auf tatsächliche Daten verweist. Der Minidriver muss versuchen, eine Sperre zu ermitteln, ob der neu erweiterte Datenstromzeiger auf einen Datenrahmen verweist oder nicht.
Siehe auch stream pointers.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | <=DISPATCH_LEVEL |
Siehe auch
KsStreamPointerAdvanceOffsets-