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