Структура 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) |