KsPinGetLeadingEdgeStreamPointer 函数 (ks.h)
KsPinGetLeadingEdgeStreamPointer 函数获取与给定引脚关联的队列的前导边缘流指针。
语法
KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
[in] PKSPIN Pin,
[in] KSSTREAM_POINTER_STATE State
);
参数
[in] Pin
指向 KSPIN 结构的指针,该结构拥有应为其获取前导边缘流指针的队列。
[in] State
此参数指定如何获取前导流指针。 可以是以下值之一:
KSSTREAM_POINTER_STATE_UNLOCKED
获取前边缘流指针,无论它是否引用数据帧。
在指针被锁定之前,无法尝试访问与指针关联的任何数据。 另请注意,可以取消与已解锁流指针关联的帧。
KSSTREAM_POINTER_STATE_LOCKED
获取并锁定前导边缘流指针。 如果没有数据帧与流指针关联,则返回 NULL。 如果返回非null 指针,则该指针是锁定的流指针,并且具有与之关联的数据帧。 无法取消与锁定的流指针关联的帧。
返回值
KsPinGetLeadingEdgeStreamPointer 返回指向 KSSTREAM_POINTER 结构或 NULL 的指针。 返回值 NULL 可能是因为没有与该引脚关联的队列,表示该引脚不使用标准传输机制。 或者,由于尝试锁定前导边缘失败,因此可能会出现 NULL 的返回值,这表示没有与前导边缘关联的数据帧。
注解
实现 以引脚为中心的处理的 筛选器通常调用 KsPinGetLeadingEdgeStreamPointer。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |
IRQL | <=DISPATCH_LEVEL |
另请参阅
KsPinGetTrailingEdgeStreamPointer