Structure KSPRIORITY (ks.h)
La structure KSPRIORITY est utilisée pour spécifier la priorité et est utilisée avec la propriété KSPROPERTY_CONNECTION_PRIORITY .
Syntaxe
typedef struct {
ULONG PriorityClass;
ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;
Membres
PriorityClass
Spécifie un nombre allant de 1 à 0xFFFFFFFF, où 1 est la priorité la moins élevée et 0xFFFFFFFF est la priorité la plus élevée. Zéro est réservé pour une utilisation ultérieure. Lors de la définition d’une valeur de classe, 0xFFFFFFFF est utilisé pour indiquer l’accès exclusif aux ressources consommées par le code pin. Les valeurs possibles sont répertoriées dans le tableau suivant.
| PriorityClass | Description |
|---|---|
| KSPRIORITY_LOW | Spécifie la priorité la plus basse. |
| KSPRIORITY_NORMAL | Spécifie la priorité normale. |
| KSPRIORITY_HIGH | Spécifie une priorité élevée. |
| KSPRIORITY_EXCLUSIVE | Spécifie la priorité la plus élevée, ce qui implique un accès exclusif aux ressources. |
PrioritySubClass
Spécifie un nombre allant de 1 à 0xFFFFFFFF, où 1 est la priorité la moins élevée au sein de la classe et 0xFFFFFFFF est la priorité la plus élevée. Zéro est réservé pour une utilisation ultérieure.
Remarques
The KSPRIORITY. Le membre PrioritySubClass permet à un client de définir l’utilisation exclusive des ressources consommées par une broche et de hiérarchiser l’utilisation de ces ressources par les broches du client au sein de cette classe exclusive. La priorité initiale d’une broche est définie par la demande de connexion généralement effectuée via KsCreatePin et est généralement KSPRIORITY_NORMAL, avec une priorité de sous-classe 1. Une broche utilise ces priorités comme paramètres lors de l’allocation de ressources partagées à partir d’un composant gérant des ressources. L’allocation de ressources se produit lorsque les formats sont définis sur des broches.
Si la suppression de ressources par un client de priorité plus élevée entraîne l’échec de la broche de filtre, le client doit être averti par le biais de l’événement KSEVENT_CONNECTION_PRIORITY (en supposant que le client s’est inscrit pour la notification d’événement de ce type).
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ks.h (inclure Ks.h) |