Platform SDK: DirectX

IDirectInput7::FindDevice

IDirectInput7::FindDeviceStatus メソッドは、システムに新たにアタッチされたデバイスのインスタンス GUID を取得する。このメソッドは、Win32 デバイス管理通知に応答して呼び出される。

HRESULT FindDevice(
  REFGUID rguidClass, 
  LPCTSTR ptszName, 
  LPGUID pguidInstance
);

パラメータ

rguidClass
アプリケーションが検索するデバイス クラスの一意な識別子。アプリケーションは、デバイス到着通知からクラス GUID を取得する (Platform SDK の DBT_DEVICEARRIVAL イベントのトピックを参照)。
ptszName
デバイスの名前。アプリケーションは、デバイス到着通知から名前を取得する。
pguidInstance
デバイスが見つかった場合にデバイスのインスタンス GUID を受け取る変数のアドレス。この値は IDirectInput7::CreateDeviceEx に渡すことができる。

戻り値

成功すれば DI_OK を返す。

失敗すれば DIERR_DEVICENOTREG を返す。GUID と名前が、DirectInput に登録されているデバイス クラスに対応しない場合は、失敗となる。たとえば、入力デバイスではなく、記憶デバイスを参照する場合などである。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dinput.h で宣言。
  インポート ライブラリ : dinput.lib を使用。

参照

デバイス変更の認識