(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) |