メインコンテンツへスキップ
入力デバイスのルート デバイス ノードのアプリケーション ローカル ID を取得します。

構文

パラメーター

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

戻り値

型: void

解説

ルート デバイス ID は、複合デバイスのルート デバイス ノードを識別するアプリケーション ローカル ID です。これにより、アプリケーションは個々のデバイス間の関係を判断できます。たとえば、一部のゲーミング キーボードは、複数のキーボード ノードを持つ複合デバイスとして自身を公開することで、同時に 8 つのキーストロークという従来の USB の制限を回避しています。これらのノードは “システム” キーボードに統合されるため、通常ユーザーがこれを意識することはありません。しかし、GameInput API を使用してキーボードごとの入力を処理する場合、この関係を理解しておくと、アプリケーションが機能をキーストロークにマッピングする際に不適切な想定 (たとえば、キーストロークは常に特定のデバイスから送られてくるという想定) を避けるのに役立ちます。 同じルート デバイス ID を報告するデバイスは、同じ複合デバイスに属しています。デバイスが複合デバイス上の複数のインターフェイスの 1 つでない場合、ルート デバイス ID は IGameInputDevice::GetDeviceId から返される ID と同じです。 GameInput v3 以前では、この情報は IGameInputDevice::GetDeviceInfo から返される GameInputDeviceInfo 構造体の deviceRootId メンバーから取得できました。

要件

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

関連項目

GameInput の概要
IGameInputDevice
IGameInputDevice::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID

バージョン履歴

最終更新日 2026年11月6日