Estructura KSPRIORITY (ks.h)
La estructura KSPRIORITY se usa para especificar la prioridad y se usa con la propiedad KSPROPERTY_CONNECTION_PRIORITY.
Sintaxis
typedef struct {
ULONG PriorityClass;
ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;
Miembros
PriorityClass
Especifica un número comprendido entre 1 y 0xFFFFFFFF, donde 1 es la prioridad mínima y 0xFFFFFFFF es la prioridad más alta. Cero está reservado para uso futuro. Al establecer un valor de clase, se usa 0xFFFFFFFF para indicar el acceso exclusivo a los recursos consumidos por el pin. Los valores posibles se enumeran en la tabla siguiente.
| PriorityClass | Descripción |
|---|---|
| KSPRIORITY_LOW | Especifica la prioridad más baja. |
| KSPRIORITY_NORMAL | Especifica la prioridad normal. |
| KSPRIORITY_HIGH | Especifica una prioridad con privilegios elevados. |
| KSPRIORITY_EXCLUSIVE | Especifica la prioridad más alta, lo que implica el acceso exclusivo a los recursos. |
PrioritySubClass
Especifica un número comprendido entre 1 y 0xFFFFFFFF, donde 1 es la prioridad mínima dentro de la clase y 0xFFFFFFFF es la prioridad más importante. Cero está reservado para uso futuro.
Observaciones
The KSPRIORITY. El miembro PrioritySubClass permite a un cliente establecer el uso exclusivo de los recursos consumidos por un pin y también priorizar el uso de esos recursos por las patillas del cliente dentro de esa clase exclusiva. La prioridad inicial de un pin se establece mediante la solicitud de conexión que normalmente se realiza a través de KsCreatePin, y normalmente se KSPRIORITY_NORMAL, con una prioridad de subclase de 1. Un pin usa estas prioridades como parámetros al asignar recursos compartidos desde cualquier componente que administre recursos. La asignación de recursos se produce cuando los formatos se establecen en patillas.
Si la eliminación de recursos por un cliente de mayor prioridad hace que se produzca un error en el pin de filtro, se debe notificar al cliente a través del evento KSEVENT_CONNECTION_PRIORITY (suponiendo que el cliente se haya registrado para la notificación de eventos de este tipo).
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | ks.h (incluya Ks.h) |