Структура KSTOPOLOGY (ks.h)

Статья
08/07/2023

Структура KSTOPOLOGY описывает топологию контактов и узлов.

Синтаксис

typedef struct {
  ULONG                       CategoriesCount;
  const GUID                  *Categories;
  ULONG                       TopologyNodesCount;
  const GUID                  *TopologyNodes;
  ULONG                       TopologyConnectionsCount;
  const KSTOPOLOGY_CONNECTION *TopologyConnections;
  const GUID                  *TopologyNodesNames;
  ULONG                       Reserved;
} KSTOPOLOGY, *PKSTOPOLOGY;

Члены

CategoriesCount

Указывает количество функциональных категорий, поддерживаемых драйвером.

Categories

Указывает на начало массива функциональных категорий, поддерживаемых драйвером.

TopologyNodesCount

Указывает количество узлов, поддерживаемых драйвером.

TopologyNodes

Указывает на начало массива идентификаторов GUID, описывающих тип каждого узла. Список узлов, связанных с потоковой передачей ядра видео, см. в разделе Узлы топологии потоковой передачи ядра. Список узлов, связанных с потоковой передачей ядра звука, см. в разделе Узлы топологии аудио.

TopologyConnectionsCount

Указывает количество записей в массиве, на который указывает TopologyConnections. Номера узлов каждой записи должны соответствовать смещениям массива узла в TopologyNodes. Если эта структура является частью HW_STREAM_HEADER мини-накопителя потоковой передачи, номера контактов должны соответствовать смещениям в массиве HW_STREAM_INFORMATION структур в структуре HW_STREAM_DESCRIPTOR мини-накопителя.

TopologyConnections

Указывает на начало массива подключений топологии для этой структуры.

TopologyNodesNames

Указывает GUID локализованного имени строки Юникода для узла, хранящегося в реестре.

Reserved

Зарезервировано для системного использования. Драйверы должны задать для этого параметра нулевое значение.

Мини-накопитель класса потока создает и передает эту структуру как часть своей HW_STREAM_HEADER структуры. Драйвер класса использует эту структуру для обработки запросов свойств топологии. Данные свойства, возвращаемые драйвером класса, определяются из структуры KSTOPOLOGY следующим образом: