Compartilhar via


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)

Confira também

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin