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

Функция KsStreamPointerAdvanceOffsets перемещает смещения StreamPointer.

Синтаксис

KSDDKAPI NTSTATUS KsStreamPointerAdvanceOffsets(
  [in] PKSSTREAM_POINTER StreamPointer,
  [in] ULONG             InUsed,
  [in] ULONG             OutUsed,
  [in] BOOLEAN           Eject
);

Параметры

[in] StreamPointer

Указатель на структуру KSSTREAM_POINTER , представляющую указатель потока, для которого необходимо продвигать смещения. StreamPointer должен находиться в состоянии блокировки при вызове этой функции.

[in] InUsed

Число байтов для продвижения входного указателя этого указателя потока.

(StreamPointer —> OffsetIn)

[in] OutUsed

Число байтов для продвижения указателя вывода этого указателя потока

(StreamPointer —> OffsetOut)

[in] Eject

Этот параметр указывает, следует ли перемещение указателя потока к следующему кадру данных. Если для этого параметра задано значение TRUE, AVStream перемещает указатель потока независимо от того, приводит ли указатель потока к концу кадра.

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

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

Комментарии

AVStream обновляет указатели на вход и выход данных и другие связанные поля по запрошенным значениям. Если сдвиг смещения приводит к нулю байтов, оставшихся в текущем кадре, AVStream перемещает указатель потока на следующий кадр данных и снова блокирует его.

Мини-диск отвечает за проверку блокировки StreamPointer перед вызовом KsStreamPointerAdvanceOffsets. Кроме того, одно продвижение не может продвинуть указатель потока дальше, чем начало следующего кадра в очереди. Таким образом, мини-накопители не должны пытаться продвинуть смещение на значение, превышающее Значение StreamPointer —> Offset*. Осталось.

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

Требования

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

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

KsStreamPointerAdvance

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock