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 |