(portcls.h) PCFILTER_DESCRIPTOR 结构

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 数组中每个元素的大小(以字节为单位)。 此值应为 8 的倍数,并且 应至少为 (PCPIN_DESCRIPTOR) 。 较大的值允许将特定于客户端的描述符信息追加到引脚描述符。

PinCount

指定 Pin 数组中的引脚 描述符数。

Pins

指向引脚描述符数组的指针。 每个数组元素都是 一个PCPIN_DESCRIPTOR 结构。

NodeSize

指定 Nodes 数组中每个元素的大小(以字节为单位)。 此值应是 8 的倍数,并且 大小应至少 为 (PCNODE_DESCRIPTOR) 。 较大的值允许将特定于客户端的描述符信息追加到节点描述符。

NodeCount

指定 Nodes 数组中的节点描述符数。

Nodes

指向节点描述符数组的指针。 每个数组元素都是 一个PCNODE_DESCRIPTOR 结构。

ConnectionCount

指定Connections数组中的连接数。

Connections

指向连接描述符数组的指针。 每个数组元素都是 一个PCCONNECTION_DESCRIPTOR 结构。

CategoryCount

指定 Categories 数组中的 GUID 数。

Categories

指向 GUID 数组的指针,该数组指定对象所属的类别。 请参阅 为音频适配器安装设备接口中有关拓扑类别的讨论。

注解

端口驱动程序通过调用 IMiniport::GetDescription 方法获取微型端口驱动程序的筛选器描述符。 筛选器描述符是描述微型端口驱动程序的引脚、节点、连接和属性的 PCFILTER_DESCRIPTOR 结构。 有关详细信息,请参阅 筛选器、固定和节点属性

要求

要求
Header portcls.h (包括 Portcls.h)

另请参阅

IMiniport::GetDescription

PCAUTOMATION_TABLE

PCCONNECTION_DESCRIPTOR

PCNODE_DESCRIPTOR

PCPIN_DESCRIPTOR