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