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 |