Share via

Структура 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 — наибольшим приоритетом. Нуль зарезервирован для использования в будущем.

Комментарии

The KSPRIORITY. Член PrioritySubClass позволяет клиенту устанавливать монопольное использование ресурсов, потребляемых контактом, а также определять приоритеты использования этих ресурсов контактами клиента в этом эксклюзивном классе. Начальный приоритет пин-кода задается запросом на подключение, который обычно выполняется через KsCreatePin, и обычно KSPRIORITY_NORMAL с приоритетом подкласса 1. Закрепление использует эти приоритеты в качестве параметров при выделении общих ресурсов из любого компонента, управляющего ресурсами. Выделение ресурсов происходит, когда форматы задаются на контактах.

Если удаление ресурсов клиентом с более высоким приоритетом приводит к сбою пин-кода фильтра, клиент должен быть уведомлен через событие KSEVENT_CONNECTION_PRIORITY (при условии, что клиент зарегистрировался для уведомления о событии этого типа).

Требования

Требование Значение
Заголовок ks.h (включая Ks.h)

См. также раздел

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin