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 |