Функция 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 и более поздних версий DirectX. |
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |