IControlChangeNotify インターフェイス (devicetopology.h)
IControlChangeNotify インターフェイスは、パーツ (コネクタまたはサブユニット) の状態が変更されたときに通知を提供します。 DeviceTopology API によって実装されるこのセクションの他のインターフェイスとは異なり、 IControlChangeNotify インターフェイスはクライアントによって実装される必要があります。 通知を受け取るために、クライアントは IPart::RegisterControlChangeCallback メソッドにパラメーターとして IControlChangeNotify インターフェイス インスタンスへのポインターを渡します。
IControlChangeNotify インターフェイスを登録すると、クライアントはインターフェイスの OnNotify メソッドを介してコールバックの形式でイベント通知を受け取ります。
IControlChangeNotify インターフェイスを実装する場合、クライアントはデッドロックと未定義の動作を回避するために、次の規則を遵守する必要があります。
- インターフェイス内のメソッドは非ブロッキングである必要があります。 クライアントは、イベント コールバック中に同期オブジェクトを待機しないでください。
- クライアントは、イベント コールバック中に IPart::UnregisterControlChangeCallback メソッドを呼び出さないでください。
- クライアントは、イベント コールバック中に MMDevice API オブジェクトの最後の参照を解放しないでください。
継承
IControlChangeNotify インターフェイスは、IUnknown インターフェイスから継承します。 IControlChangeNotify には、次の種類のメンバーもあります。
メソッド
IControlChangeNotify インターフェイスには、これらのメソッドがあります。
| IControlChangeNotify::OnNotify OnNotify メソッドは、コネクタまたはサブユニットの状態が変更されたときにクライアントに通知します。 |
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | devicetopology.h |