Estructura KSPRIORITY (ks.h)

  • Artículo

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, 0xFFFFFFFF se usa 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 prioritaria. Cero está reservado para uso futuro.

Comentarios

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 provoca un error en el pin de filtro, el cliente debe recibir una notificación a través del evento KSEVENT_CONNECTION_PRIORITY (suponiendo que el cliente se había registrado para la notificación de eventos de este tipo).

Requisitos

Requisito Valor
Header ks.h (incluya Ks.h)

Consulte también

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin