Структура 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 (include Ks.h) |