KSPRIORITY-Struktur (ks.h)
Die KSPRIORITY-Struktur wird zum Angeben der Priorität verwendet und mit der KSPROPERTY_CONNECTION_PRIORITY-Eigenschaft verwendet.
Syntax
typedef struct {
ULONG PriorityClass;
ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;
Angehörige
PriorityClass
Gibt eine Zahl zwischen 1 und 0xFFFFFFFF an, wobei 1 die geringste Priorität und 0xFFFFFFFF die höchste Priorität ist. 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 ist. Null ist für die zukünftige Verwendung reserviert.
Bemerkungen
Die KSPRIORITY. PrioritySubClass-Member ermöglicht es einem Client, die ausschließliche Verwendung von Ressourcen festzulegen, die von einer Pin verbraucht werden, und die Verwendung dieser Ressourcen durch die Pins des Clients innerhalb dieser exklusiven Klasse zu priorisieren. Die anfängliche Priorität eines Pins wird von der Verbindungsanforderung festgelegt, die in der Regel über KsCreatePinausgeführt wird und in der Regel KSPRIORITY_NORMAL ist, mit einer Unterklassenpriorität von 1. Ein Pin verwendet diese Prioritäten als Parameter, wenn freigegebene Ressourcen von allen Komponenten zugeordnet werden, die Ressourcen verwalten. Die Ressourcenzuordnung erfolgt, wenn Formate für Pins festgelegt werden.
Wenn das Entfernen von Ressourcen durch einen Client mit höherer Priorität bewirkt, dass die Filter-Pin fehlschlägt, muss der Client über das KSEVENT_CONNECTION_PRIORITY-Ereignis benachrichtigt werden (vorausgesetzt, der Client hatte sich für die Ereignisbenachrichtigung dieses Typs registriert).
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ks.h (enthalten Ks.h) |