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

KsStreamPointerAdvance

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerClone

KsStreamPointerDelete

KsStreamPointerLock

KsStreamPointerUnlock