iControlChangeNotify 接口 (devicetopology.h)

当部件 (连接器或子单元的状态) 更改时, IControlChangeNotify 接口提供通知。 与本部分中由 DeviceTopology API 实现的其他接口不同, IControlChangeNotify 接口必须由客户端实现。 为了接收通知,客户端将指向其 IControlChangeNotify 接口实例的指针作为参数传递给 IPart::RegisterControlChangeCallback 方法。

注册其 IControlChangeNotify 接口后,客户端通过接口中的 OnNotify 方法以回调的形式接收事件通知。

在实现 IControlChangeNotify 接口时,客户端应遵守以下规则,以避免死锁和未定义的行为:

  • 接口中的方法必须是非阻止的。 客户端不应在事件回调期间等待同步对象。
  • 客户端不应在事件回调期间调用 IPart::UnregisterControlChangeCallback 方法。
  • 客户端不应在事件回调期间释放 MMDevice API 对象上的最终引用。

继承

IControlChangeNotify 接口继承自 IUnknown 接口。 IControlChangeNotify 还具有以下类型的成员:

方法

IControlChangeNotify 接口包含以下方法。

 
IControlChangeNotify::OnNotify

当连接器或子单元的状态发生更改时,OnNotify 方法会通知客户端。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

核心音频接口

DeviceTopology API

IPart::RegisterControlChangeCallback

IPart::UnregisterControlChangeCallback