KSPRIORITY 结构 (ks.h)

KSPRIORITY 结构用于指定优先级,并与 KSPROPERTY_CONNECTION_PRIORITY 属性一起使用。

语法

typedef struct {
  ULONG PriorityClass;
  ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;

成员

PriorityClass

指定范围从 1 到 0xFFFFFFFF 的数字,其中 1 是优先级最低,0xFFFFFFFF是最高优先级。 保留零供将来使用。 设置类值时,0xFFFFFFFF用于指示对引脚消耗的资源进行独占访问。 下表列出了可能的值。

PriorityClass 说明
KSPRIORITY_LOW 指定最低优先级。
KSPRIORITY_NORMAL 指定正常优先级。
KSPRIORITY_HIGH 指定提升的优先级。
KSPRIORITY_EXCLUSIVE 指定最高优先级,这意味着对资源的独占访问。

PrioritySubClass

指定范围从 1 到 0xFFFFFFFF 的数字,其中 1 是类中优先级最低的,0xFFFFFFFF是最高优先级。 保留零供将来使用。

注解

KSPRIORITY。PrioritySubClass 成员允许客户端设置引脚占用的资源的独占使用,并按该独占类中的客户端引脚设置这些资源的使用优先级。 引脚的初始优先级由通常通过 KsCreatePin 执行的连接请求设置,通常KSPRIORITY_NORMAL,子类优先级为 1。 从管理资源的任何组件分配共享资源时,引脚使用这些优先级作为参数。 在引脚上设置格式时,会发生资源分配。

如果优先级较高的客户端删除资源导致筛选器 PIN 失败,则必须通过KSEVENT_CONNECTION_PRIORITY事件 (通知客户端,前提是客户端已注册此类型的事件通知) 。

要求

要求
Header ks.h (包括 Ks.h)

另请参阅

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin