GrabberListener::deviceListChanged Method
有効なビデオキャプチャデバイスのリストに変更があった場合にこのメソッドがコールされます。
構文
virtual void deviceListChanged( Grabber& caller, const DeviceListChangeData& reserved );| パラメータ | 説明 |
|---|---|
| caller | このメソッドをコールするGrabberオブジェクト。 |
| reseaved | 未使用 |
備考
このコールバックメソッドはICImagingControlで有効なデバイスリストに変化があった時にコールされます。たとえば、新しいデバイスが接続され正しくドライバがインストールされたとき、またデバイスが取り外され有効でなくなった場合に発行されます。
このコールバックメソッドはGrabberListenerオブジェクトGrabber::addListenerクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::addListener MethodがeDEVICELISTCHANGEDかeALLのパラメータで登録された場合にのみ動作します。
deviceListChangedイベント内で引き起こされた例外はロストされます。従って、例外を引き起こしたバグは認識できません。これを防ぐために、すべてのイベントハンドラー中のコードはtry ... catchブロックによりカバーされるべきです。エラーメッセージの表示が必要な場合、メッセージボックスは使用せず、TRACE(...)のようなデバッグトレースを使用してください。でなければアプリケーションのハングアップなど、問題を引き起こすことがあります。
関連項目
GrabberListenerクラスライブラリリファレンス＞クラス＞GrabberListener, Grabber::addListenerクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::addListener Method, GrabberListener::tListenerTypeクラスライブラリリファレンス＞クラス＞GrabberListener＞GrabberListener::tListenerType, GrabberListener::deviceLostクラスライブラリリファレンス＞クラス＞GrabberListener＞GrabberListener::deviceLost Method, Grabber::getAvailableVideoCaptureDevicesクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getAvailableVideoCaptureDevices Method