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 compris entre 1 et 0xFFFFFFFF, où 1 est la priorité minimale 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 la broche. 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 compris entre 1 et 0xFFFFFFFF, où 1 est la priorité la moins élevée dans 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 de 1. Une broche utilise ces priorités comme paramètres lors de l’allocation de ressources partagées à partir de n’importe quel composant gérant les 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é supérieure provoque l’échec de l’épingle de filtre, le client doit être averti par le biais de l’événement KSEVENT_CONNECTION_PRIORITY (en supposant que le client avait inscrit pour la notification d’événement de ce type).
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ks.h (include Ks.h) |