メインコンテンツへスキップ
指定したライティング グループの選択範囲に含まれる、入力デバイス上のランプの数を取得します。

構文

パラメーター

group
型: GameInputLightingGroups
ランプを数える対象のライティング グループの選択範囲。1 つ以上の名前付きグループ フラグ、GameInputLightingGroupAll、または GameInputLightingGroupUnknown を指定できます。

戻り値

型: uint32_t 選択範囲内のランプの数。デバイスの選択範囲内にランプがない場合、または group に未定義のフラグが含まれている場合は 0 を返します。

解説

group の値は次のように解釈されます。 個々のランプを序数で指定する場合、選択範囲のランプ数は、IGameInputDevice::SetLightingColor の groupOrderIndex パラメーターの上限 (この値自体は含まない) になります。例外は GameInputLightingGroupKeyboardKey で、このグループでは個々のランプを代わりにキーボード スキャン コードで指定します。 次の例では、フェイス ボタン グループ内の各ランプを、それぞれ異なる濃さの緑で点灯します。
ランプの数は、デバイス オブジェクトの有効期間中は変化しません。
ライティングのサポートは、デバイスとプラットフォームによって異なります。現在、GameInput は、Windows Dynamic Lighting (LampArray) デバイスと DualSense コントローラーのライトバーでのライティングをサポートしています。

要件

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

関連項目

GameInput の概要
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroups
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors

バージョン履歴

最終更新日 2026年11月6日