KsStreamPointerLock 函数 (ks.h)

KsStreamPointerLock 函数尝试锁定指定的流指针。

语法

KSDDKAPI NTSTATUS KsStreamPointerLock(
  [in] PKSSTREAM_POINTER StreamPointer
);

参数

[in] StreamPointer

指向 KSSTREAM_POINTER 结构的指针,表示尝试锁定的流指针。

返回值

KsStreamPointerLock 返回STATUS_SUCCESS,指示流指针已被锁定或相应的错误代码。 STATUS_DEVICE_NOT_READY是指示无法锁定帧的常见错误代码。 此错误代码通常意味着已取消 StreamPointer 指向的帧。

言论

锁定的流指针保证存在与流指针关联的数据帧,并且只要保留锁,此帧就不会取消。 微型驱动程序应在尝试访问流指针指向的数据之前锁定流指针。

如果流指针引用的引脚指定应使用KSPIN_FLAG_GENERATE_MAPPINGS生成 DMA 散点/收集映射,则 AVStream 会在锁定流指针时生成映射。

另请参阅 流指针

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL <=DISPATCH_LEVEL

另请参阅

KsStreamPointerUnlock