Estrutura KSPRIORITY (ks.h)
A estrutura KSPRIORITY é usada para especificar a prioridade e é usada com a propriedade KSPROPERTY_CONNECTION_PRIORITY .
Sintaxe
typedef struct {
ULONG PriorityClass;
ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;
Membros
PriorityClass
Especifica um número que varia de 1 a 0xFFFFFFFF, em que 1 é a prioridade mínima e 0xFFFFFFFF é a prioridade mais alta. Zero é reservado para uso futuro. Ao definir um valor de classe, 0xFFFFFFFF é usado para indicar acesso exclusivo aos recursos consumidos pelo pino. Os valores possíveis são listados na tabela a seguir.
| Priorityclass | Descrição |
|---|---|
| KSPRIORITY_LOW | Especifica a prioridade mais baixa. |
| KSPRIORITY_NORMAL | Especifica a prioridade normal. |
| KSPRIORITY_HIGH | Especifica uma prioridade elevada. |
| KSPRIORITY_EXCLUSIVE | Especifica a prioridade mais alta, o que implica acesso exclusivo aos recursos. |
PrioritySubClass
Especifica um número que varia de 1 a 0xFFFFFFFF, em que 1 é a prioridade mínima dentro da classe e 0xFFFFFFFF é a prioridade mais. Zero é reservado para uso futuro.
Comentários
A KSPRIORITY. O membro PrioritySubClass permite que um cliente defina o uso exclusivo de recursos consumidos por um pin e também priorize o uso desses recursos pelos pinos do cliente nessa classe exclusiva. A prioridade inicial de um pin é definida pela solicitação de conexão normalmente executada por meio de KsCreatePin e geralmente é KSPRIORITY_NORMAL, com uma prioridade de subclasse de 1. Um pin usa essas prioridades como parâmetros ao alocar recursos compartilhados de qualquer componente que gerencia recursos. A alocação de recursos ocorre quando os formatos são definidos em pinos.
Se a remoção de recursos por um cliente de prioridade mais alta fizer com que o pino de filtro falhe, o cliente deverá ser notificado por meio do evento KSEVENT_CONNECTION_PRIORITY (supondo que o cliente tenha se registrado para notificação de evento desse tipo).
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ks.h (inclua Ks.h) |