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

Статья
02/26/2024

Структура PCFILTER_DESCRIPTOR описывает реализацию фильтра драйвером минипорта. Структура определяет контакты, узлы, подключения и свойства фильтра.

Синтаксис

typedef struct {
  ULONG                         Version;
  const PCAUTOMATION_TABLE      *AutomationTable;
  ULONG                         PinSize;
  ULONG                         PinCount;
  const PCPIN_DESCRIPTOR        *Pins;
  ULONG                         NodeSize;
  ULONG                         NodeCount;
  const PCNODE_DESCRIPTOR       *Nodes;
  ULONG                         ConnectionCount;
  const PCCONNECTION_DESCRIPTOR *Connections;
  ULONG                         CategoryCount;
  const GUID                    *Categories;
} PCFILTER_DESCRIPTOR, *PPCFILTER_DESCRIPTOR;

Члены

Version

Зарезервировано. Инициализируйте до нуля.

AutomationTable

Указатель на таблицу автоматизации. Это структура типа PCAUTOMATION_TABLE. В таблице автоматизации указываются обработчики для свойств экземпляра фильтра.

PinSize

Задает размер в байтах каждого элемента в массиве Pins . Это значение должно быть кратно восьми и иметь значение по крайней мере sizeof(PCPIN_DESCRIPTOR). Большие значения позволяют добавлять сведения о дескрипторе конкретного клиента в дескрипторы закрепления.

PinCount

Указывает количество дескрипторов контактов в массиве Pins .

Pins

Указатель на массив дескрипторов контактов. Каждый элемент массива является PCPIN_DESCRIPTOR структурой.

NodeSize

Задает размер в байтах каждого элемента в массиве Nodes . Это значение должно быть кратно восьми и иметь значение по крайней мере sizeof(PCNODE_DESCRIPTOR). Большие значения позволяют добавлять сведения о дескрипторе конкретного клиента в дескрипторы узла.

NodeCount

Указывает количество дескрипторов узлов в массиве Nodes .

Nodes

Указатель на массив дескрипторов узлов. Каждый элемент массива является PCNODE_DESCRIPTOR структурой.

ConnectionCount

Указывает количество подключений в массиве Connections.

Connections

Указатель на массив дескрипторов соединений. Каждый элемент массива является PCCONNECTION_DESCRIPTOR структурой.

CategoryCount

Указывает количество идентификаторов GUID в массиве категорий .

Categories

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

Драйвер порта получает дескриптор фильтра драйвера miniport, вызывая метод IMiniport::GetDescription . Дескриптор фильтра — это структура PCFILTER_DESCRIPTOR , описывающая контакты, узлы, подключения и свойства драйвера мини-порта. Дополнительные сведения см. в разделе Свойства фильтра, закрепления и узла.