Struttura KSPRIORITY (ks.h)
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) |