Struttura KSPRIORITY (ks.h)

  • Articolo

La struttura KSPRIORITY viene usata per specificare la priorità e viene usata con la proprietà KSPROPERTY_CONNECTION_PRIORITY .

Sintassi

typedef struct {
  ULONG PriorityClass;
  ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;

Members

PriorityClass

Specifica un numero compreso tra 1 e 0xFFFFFFFF, dove 1 è la priorità minima e 0xFFFFFFFF è la priorità più alta. Zero è riservato per l'uso futuro. Quando si imposta un valore di classe, 0xFFFFFFFF viene usato per indicare l'accesso esclusivo alle risorse utilizzate dal pin. I valori possibili sono elencati nella tabella seguente.

PriorityClass Descrizione
KSPRIORITY_LOW Specifica la priorità più bassa.
KSPRIORITY_NORMAL Specifica la priorità normale.
KSPRIORITY_HIGH Specifica una priorità con privilegi elevati.
KSPRIORITY_EXCLUSIVE Specifica la priorità più alta, che implica l'accesso esclusivo alle risorse.

PrioritySubClass

Specifica un numero compreso tra 1 e 0xFFFFFFFF, dove 1 è la priorità minima all'interno della classe e 0xFFFFFFFF è la priorità più elevata. Zero è riservato per l'uso futuro.

Commenti

The KSPRIORITY. Il membro PrioritySubClass consente a un client di impostare l'uso esclusivo delle risorse utilizzate da un pin e anche per assegnare priorità all'uso di tali risorse dai pin del client all'interno di tale classe esclusiva. La priorità iniziale di un pin viene impostata dalla richiesta di connessione eseguita in genere tramite KsCreatePin ed è in genere KSPRIORITY_NORMAL, con una priorità di sottoclasse pari a 1. Un pin usa queste priorità come parametri durante l'allocazione di risorse condivise da qualsiasi componente che gestisce le risorse. L'allocazione delle risorse si verifica quando i formati vengono impostati sui pin.

Se la rimozione delle risorse da un client con priorità superiore causa l'esito negativo del pin del filtro, il client deve ricevere una notifica tramite l'evento KSEVENT_CONNECTION_PRIORITY (presupponendo che il client avesse registrato per la notifica degli eventi di questo tipo).

Requisiti

Requisito Valore
Intestazione ks.h (include Ks.h)

Vedi anche

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin