KSPRIORITY-Struktur (ks.h)
Die KSPRIORITY-Struktur wird verwendet, um die Priorität anzugeben, und wird mit der eigenschaft KSPROPERTY_CONNECTION_PRIORITY verwendet.
Syntax
typedef struct {
ULONG PriorityClass;
ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;
Member
PriorityClass
Gibt eine Zahl von 1 bis 0xFFFFFFFF an, wobei 1 die geringste Priorität und 0xFFFFFFFF die höchste Priorität hat. Null ist für die zukünftige Verwendung reserviert. Beim Festlegen eines Klassenwerts wird 0xFFFFFFFF verwendet, um den exklusiven Zugriff auf die vom Pin verbrauchten Ressourcen anzugeben. Mögliche Werte sind in der folgenden Tabelle aufgeführt.
| Priorityclass | BESCHREIBUNG |
|---|---|
| KSPRIORITY_LOW | Gibt die niedrigste Priorität an. |
| KSPRIORITY_NORMAL | Gibt die normale Priorität an. |
| KSPRIORITY_HIGH | Gibt eine erhöhte Priorität an. |
| KSPRIORITY_EXCLUSIVE | Gibt die höchste Priorität an, was den exklusiven Zugriff auf Ressourcen impliziert. |
PrioritySubClass
Gibt eine Zahl zwischen 1 und 0xFFFFFFFF an, wobei 1 die geringste Priorität innerhalb der Klasse und 0xFFFFFFFF die höchste Priorität hat. Null ist für die zukünftige Verwendung reserviert.
Hinweise
Die KSPRIORITY. Das PrioritySubClass-Element ermöglicht es einem Client, die exklusive Nutzung der von einem Pin genutzten Ressourcen festzulegen und die Verwendung dieser Ressourcen durch die Pins des Clients innerhalb dieser exklusiven Klasse zu priorisieren. Die anfängliche Priorität eines Pins wird durch die Verbindungsanforderung festgelegt, die normalerweise über KsCreatePin ausgeführt wird, und ist in der Regel KSPRIORITY_NORMAL, mit einer Unterklassepriorität von 1. Ein Pin verwendet diese Prioritäten als Parameter beim Zuweisen freigegebener Ressourcen aus einer beliebigen Komponente, die Ressourcen verwaltet. Die Ressourcenzuordnung tritt auf, wenn Formate für Pins festgelegt werden.
Wenn das Entfernen von Ressourcen durch einen Client mit höherer Priorität zu einem Fehler des Filterpins führt, muss der Client über das KSEVENT_CONNECTION_PRIORITY-Ereignis benachrichtigt werden (vorausgesetzt, der Client hatte sich für ereignisbenachrichtigungen dieses Typs registriert).
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ks.h (einschließlich Ks.h) |