IDirectInput8::FindDevice
システムに新しく接続されたデバイスのインスタンス グローバル一意識別子 (GUID) を取得します。Microsoft Win32 デバイス管理通知に応答して呼び出されます。
HRESULT
FindDevice(
REFGUID rguidClass,
LPCTSTR ptszName,
LPGUID pguidInstance
);
パラメータ
- rguidClass
アプリケーションが検索する対象のデバイスが属するデバイス クラスの一意識別子。アプリケーションは、デバイス挿入通知からクラス GUID を取得します。詳しくは、Microsoft Platform Software Development Kit (SDK) の DBT_DEVICEARRIVAL イベントに関する説明を参照してください。 - ptszName
デバイスの名前。アプリケーションは、デバイス挿入通知からこの名前を取得します。 - pguidInstance
デバイスが検出された場合に、デバイスのインスタンス GUID を受け取る変数のアドレス。この値は IDirectInput8::CreateDevice に渡すことができます。
戻り値
メソッドが正常に実行された場合、戻り値は DI_OK です。メソッドが失敗した場合は、戻り値が DIERR_DEVICENOTREG になる可能性があります。GUID と名前が、DirectInput に登録されたデバイス クラスに対応していない場合は、メソッドが失敗します。たとえば、入力デバイスではなくストレージ デバイスを指している場合などです。
要件
ヘッダー: Dinput.h 宣言