Struttura KSPRIORITY (ks.h)
La struttura KSPRIORITY viene utilizzata per specificare la priorità e viene utilizzata con la proprietà KSPROPERTY_CONNECTION_PRIORITY.
Sintassi
typedef struct {
ULONG PriorityClass;
ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;
Membri
PriorityClass
Specifica un numero compreso tra 1 e 0xFFFFFFFF, dove 1 è la priorità minima e 0xFFFFFFFF è la priorità più alta. Zero è riservato per 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à elevata. |
| 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 uso futuro.
Osservazioni
The KSPRIORITY. Il membro PrioritySubClass consente a un client di impostare l'uso esclusivo delle risorse utilizzate da un pin e di classificare in ordine di priorità l'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 KsCreatePine viene in genere KSPRIORITY_NORMAL, con priorità di sottoclasse pari a 1. Un pin usa queste priorità come parametri quando si allocano 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à più alta causa l'esito negativo del pin del filtro, il client deve ricevere una notifica tramite l'evento KSEVENT_CONNECTION_PRIORITY (presupponendo che il client sia stato registrato per la notifica degli eventi di questo tipo).
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ks.h (include Ks.h) |