IPinCount 接口 (portcls.h)

接口 IPinCount 为微型端口驱动程序提供了一种在引脚实例化和关闭时动态监视和操作其引脚计数的方法。 此接口在微型端口驱动程序中实现。 若要确定微型端口驱动程序是否支持此接口,端口驱动程序使用 REFIID IID_IPinCount调用微型端口对象的 QueryInterface 方法。 IPinCount 继承自 IUnknown 接口。

如果微型端口驱动程序实现,以下端口驱动程序将使用微型端口驱动程序的 IPinCount 接口:WaveCyclic、WavePci、MIDI、DMus 和拓扑。

IPinCount 是微型端口驱动程序在需要执行以下任一操作或两项操作时可以支持的可选接口:

  • 收到内核流式处理引脚计数更改的显式通知。
  • 动态更改其引脚计数。
例如,对于波形音频设备,具有不同属性的流 (3D、立体声/单声道等) 在消耗的硬件资源量方面也可能具有不同的“权重”。

打开“重量级”流时,微型端口驱动程序可能需要将可用引脚计数递减 2 而不是 1,以便更准确地指示可以使用剩余资源创建的引脚数。

当关闭“重量级”流时,该过程将相反。 可用引脚计数可能会增加多个,以反映可以从新释放的资源创建两个或更多“轻型”流这一事实。

如果微型端口驱动程序不支持 接口 IPinCount ,则端口驱动程序使用筛选器 PCPIN_DESCRIPTOR 数组中的静态初始化引脚计数。

接口 IPinCount 提供单个方法。 绑定到微型端口驱动程序的端口驱动程序调用此方法以响应引脚计数查询。

继承

IPinCount 接口继承自 IUnknown 接口。

方法

IPinCount 接口具有这些方法。

 
IPinCount::P inCount

PinCount 方法查询微型端口驱动程序的引脚计数。

要求

要求
目标平台 Windows
标头 portcls.h