PCFILTER_DESCRIPTOR结构 (portcls.h)

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

指定 Pins 数组中的固定描述符的数目。

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