PCPIN_DESCRIPTOR 结构 (portcls.h)

项目
02/29/2024

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 值的含义类似于：