Структура KSTOPOLOGY (ks.h)
Структура 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 следующим образом:
Требования
| Требование | Значение |
|---|---|
| Заголовок | ks.h (включая Ks.h) |