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 会在流指针锁定时生成映射。

另请参阅Stream指针

要求

要求
最低受支持的客户端 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib
IRQL <=DISPATCH_LEVEL

另请参阅

KsStreamPointerUnlock