Поделиться через


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

Функция 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

См. также раздел

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock