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 |