KsPinGetLeadingEdgeStreamPointer 函数 (ks.h)

项目
03/05/2024

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