структура PCNODE_DESCRIPTOR (portcls.h)

Структура PCNODE_DESCRIPTOR описывает узел в фильтре, который реализует драйвер мини-порта топологии.

Синтаксис

typedef struct {
  ULONG                    Flags;
  const PCAUTOMATION_TABLE *AutomationTable;
  const GUID               *Type;
  const GUID               *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;

Члены

Flags

Установите значение нулю. В настоящее время биты флагов не определены.

AutomationTable

Указатель на таблицу автоматизации, которая представляет собой структуру типа PCAUTOMATION_TABLE. Этот член может иметь значение NULL , чтобы указать, что поддержка автоматизации не поддерживается. Таблица автоматизации задает обработчики свойств и событий, принадлежащих экземпляру узла.

Type

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

Name

Указатель на GUID, представляющий имя этого узла топологии. Этот GUID указан в запросеget-property KSPROPERTY_TOPOLOGY_NAME, чтобы получить соответствующую строку имени узла. Этот указатель можно задать в значение NULL , чтобы указать, что GUID в элементе type следует использовать для определения имени узла.

Замечания

Если фильтр содержит только один узел типа, указанного членом type , то элемент Name можно указать как NULL , так как значение type достаточно для уникальной идентификации узла в фильтре. Если фильтр содержит два или более узлов одного типа, элементы name для этих узлов должны быть не NULL.

Например, если фильтр содержит один узел SUM, элемент Type для этого узла указывает на значение GUID KSNODETYPE_SUM, а элемент name имеет значение NULL. При запросе имени этого узла свойство KSPROPERTY_TOPOLOGY_NAME после определения значения имени узла имеет значение NULL, извлекает строку имени из записи реестра для GUID KSNODETYPE_SUM. Однако один и тот же фильтр может содержать несколько узлов тома, в этом случае значения type для этих узлов указывают на одно и то же значение GUID, KSNODETYPE_VOLUME, а значение Name должно однозначно определить каждый из узлов тома. Значение name для узла управления томом, входным волной, например, должно указывать на значение GUID KSAUDFNAME_WAVE_IN_VOLUME (определено в ksmedia.h). Запись реестра для этого GUID содержит строку имени, которую извлекает свойство KSPROPERTY_TOPOLOGY_NAME для узла.

Структура PCFILTER_DESCRIPTOR содержит указатель на массив PCNODE_DESCRIPTOR структур.

Простой пример кода, показывающий, как используется структура PCNODE_DESCRIPTOR , см. в разделе "Экспонирование топологии фильтра".

Требования

См. также

KSPROPERTY_TOPOLOGY_NAME

PCAUTOMATION_TABLE

PCFILTER_DESCRIPTOR