Функция KsStreamPointerAdvance (ks.h)

Статья
02/26/2024

Функция KsStreamPointerAdvance перемещает указатель потока на следующий кадр данных.

Синтаксис

KSDDKAPI NTSTATUS KsStreamPointerAdvance(
  [in] PKSSTREAM_POINTER StreamPointer
);

Параметры

[in] StreamPointer

Указатель на структуру KSSTREAM_POINTER , представляющую указатель потока для перехода на следующий доступный кадр данных.

Возвращаемое значение

KsStreamPointerAdvance возвращает STATUS_SUCCESS, чтобы указать на успешное продвижение. В противном случае возвращается код ошибки. STATUS_DEVICE_NOT_READY является наиболее часто возвращаемым кодом ошибки и часто указывает на то, что блокировка указателя потока после продвижения завершилась ошибкой. Другими словами, StreamPointer ссылается на последний кадр в очереди.

Если StreamPointer заблокирован во время вызова, AVStream разблокирует его перед продвижением. После этого указатель потока возвращается в исходное состояние (заблокировано или разблокировано) в новом кадре.

Попытка перейти к разблокировке указателя потока всегда завершается успешно и возвращает STATUS_SUCCESS. Так как указатель потока не заблокирован, невозможно определить, ссылается ли указатель потока на фактические данные. Мини-driver должен попытаться заблокировать, чтобы определить, ссылается ли новый расширенный указатель потока на кадр данных.

См. также Stream указатели.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ks.h (включая Ks.h)
Библиотека	Ks.lib
IRQL	<=DISPATCH_LEVEL