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) |