メインコンテンツへスキップ
入力デバイスを一意に識別するアプリケーション ローカル ID を取得します。

構文

パラメーター

deviceId   _Out_
型: APP_LOCAL_DEVICE_ID*
デバイスのアプリケーション ローカル ID を受け取ります。

戻り値

型: void

解説

デバイス ID はアプリケーション ローカル ID であり、デバイスを一意に識別する 256 ビットのハッシュ値です。この ID は、デバイスが同じ USB ポートに接続されている限り、アプリケーションの実行やシステムの再起動をまたいでも、特定のデバイスに対して同じ値のままです。ハッシュは、呼び出し元のアプリケーションとシステムに固有の情報を一部使用して生成されるため、同じデバイスでもアプリケーションごとに異なる ID になります。 ID は安定しているため、保存しておくことでデバイス (ユーザーが好むコントローラーなど) を記憶しておき、後で IGameInput::FindDeviceFromId を呼び出して一致するデバイス オブジェクトを検索できます。 複合デバイス上の複数のインターフェイスの 1 つであるデバイスについては、IGameInputDevice::GetDeviceRootId を使用してルート デバイスの ID を取得します。デバイスが複合デバイスの一部でない場合、デバイス ID とルート デバイス ID は同じです。 GameInput v3 以前では、この情報は IGameInputDevice::GetDeviceInfo から返される GameInputDeviceInfo 構造体の deviceId メンバーから取得できました。

要件

ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体

関連項目

GameInput の概要
IGameInputDevice
IGameInputDevice::GetDeviceRootId
IGameInput::FindDeviceFromId
APP_LOCAL_DEVICE_ID

バージョン履歴

最終更新日 2026年11月6日