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

Функция KsStreamPointerLock пытается заблокировать указанный указатель потока.

Синтаксис

KSDDKAPI NTSTATUS KsStreamPointerLock(
  [in] PKSSTREAM_POINTER StreamPointer
);

Параметры

[in] StreamPointer

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

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

KsStreamPointerLock возвращает либо STATUS_SUCCESS, указывающее, что указатель потока заблокирован, либо соответствующий код ошибки. STATUS_DEVICE_NOT_READY — это обычный код ошибки, указывающий, что фрейм не удалось заблокировать. Этот код ошибки часто означает, что кадр, на который указывал StreamPointer , был отменен.

Комментарии

Указатель заблокированного потока гарантирует, что с указателем потока связан кадр данных, и этот кадр не будет отменен до тех пор, пока блокировка будет сохранена. Мини-накопитель должен заблокировать указатель потока перед попыткой доступа к данным, на которые указывает указатель потока.

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

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

Требования

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

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

KsStreamPointerUnlock