PCPIN_DESCRIPTOR结构（portcls.h）

项目
02/07/2025

PCPIN_DESCRIPTOR 结构描述引脚工厂。

语法

typedef struct {
  ULONG                    MaxGlobalInstanceCount;
  ULONG                    MaxFilterInstanceCount;
  ULONG                    MinFilterInstanceCount;
  const PCAUTOMATION_TABLE *AutomationTable;
  KSPIN_DESCRIPTOR         KsPinDescriptor;
} PCPIN_DESCRIPTOR, *PPCPIN_DESCRIPTOR;

成员

MaxGlobalInstanceCount

指定可以实例化此引脚类型的全局最大次数。全局最大值计算适配器驱动程序可在筛选器的所有实例中支持的引脚实例数。计数可以设置为零，以指示无法实例化引脚。 ULONG（-1）的值指示引脚可以实例化任意次数。任何其他值都指示可以实例化引脚的特定次数。

MaxFilterInstanceCount

指定引脚可以在筛选器的单个实例上实例化的最大次数。计数可以设置为零，以指示无法实例化引脚。 ULONG（-1）的值指示引脚可以实例化任意次数。任何其他值都指示可以实例化引脚的特定次数。

MinFilterInstanceCount

指定在筛选器实例上需要实例化引脚的最小次数。此成员是固定实例数的明确下限，该实例必须存在，以便筛选器能够正常工作。

AutomationTable

指向自动化表的指针。此成员是指向 PCAUTOMATION_TABLE类型的结构的指针。指针可以 NULL，以指示不支持任何自动化。自动化表指定属于固定实例的属性和事件的处理程序。

KsPinDescriptor

描述引脚工厂。此成员是 KSPIN_DESCRIPTOR类型的结构。引脚工厂可以有零个接口和零个介质。在所有情况下，都会忽略接口列表。标准中型列表默认为仅包含设备 I/O 的列表（KSMEDIUM_STANDARD_DEVIO）。

言论

此结构用于描述微型端口驱动程序实现的每个引脚工厂。驱动程序的 PCFILTER_DESCRIPTOR 结构包含指向 PCPIN_DESCRIPTOR 结构的数组的指针。数组中的元素数等于筛选器中的引脚工厂数。

MaxGlobalInstanceCount、MaxFilterInstanceCount，MinFilterInstanceCount 成员是描述引脚的资源限制和功能要求的最大和最小计数。自动初始化 PCPIN_DESCRIPTOR 数组只能提供可用引脚资源的静态估计值。 IPinCount：:P inCount 方法为驱动程序提供了一种在分配和释放引脚时动态修改其可用引脚资源列表的方法。

MaxGlobalInstanceCount 值类似于：