Функция KsStreamPointerLock (ks.h)
Функция KsStreamPointerLock пытается заблокировать указанный указатель потока.
Синтаксис
KSDDKAPI NTSTATUS KsStreamPointerLock(
[in] PKSSTREAM_POINTER StreamPointer
);
Параметры
[in] StreamPointer
Указатель на структуру KSSTREAM_POINTER, представляющую указатель потока для попытки блокировки.
Возвращаемое значение
KsStreamPointerLock возвращает либо STATUS_SUCCESS, указывая, что указатель потока заблокирован или соответствующий код ошибки. STATUS_DEVICE_NOT_READY — это обычный код ошибки, указывающий, что кадр не удалось заблокировать. Этот код ошибки часто означает, что кадр, на который был отменен StreamPointer.
Замечания
Указатель на заблокированный поток гарантирует, что существует кадр данных, связанный с указателем потока, и что этот кадр не отменяется до тех пор, пока блокировка сохраняется. Мини-driver должен заблокировать указатель потока перед попыткой доступа к данным, к которым указывает указатель потока.
Если пин-код, на который ссылается указатель потока, указывает, что сопоставления точечной или сборной DMA должны создаваться с помощью KSPIN_FLAG_GENERATE_MAPPINGS, AVStream создает сопоставления при блокировке указателя потока.
См. также указатели потока.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |