メインコンテンツへスキップ
入力デバイスが制御可能なランプを備えているライティング グループを取得します。

構文

パラメーター

このメソッドにはパラメーターがありません。

戻り値

型: GameInputLightingGroups デバイス上のランプを 1 つ以上含む、すべての名前付きライティング グループの GameInputLightingGroups フラグの組み合わせ。デバイスのどの名前付きグループにもランプがない場合は GameInputLightingGroupUnknown (0) を返します。

解説

返される値の各フラグは、GameInputLightingGroupFaceButtons や GameInputLightingGroupCenterLight など、IGameInputDevice::SetLightingColor で指定できるランプの名前付きグループを示します。GameInputLightingGroupUnknown の値は 0 であるため、このメソッドがこれをグループとして報告することはありません。 デバイスは、どの名前付きグループにも属さないランプを備えている場合があります。そのため、戻り値が 0 であっても、デバイスにランプがないとは限りません。デバイスがライティングをサポートしているかどうかを判断するには、IGameInputDevice::GetSupportedInput に GameInputKindLighting が含まれているかどうかを確認するか、GameInputLightingGroupAll を指定して IGameInputDevice::GetSupportedLightingGroupSize を呼び出します。名前付きグループに属さないランプの数を数えるには、GameInputLightingGroupUnknown を指定して GetSupportedLightingGroupSize を呼び出します。 次の例では、該当するグループを備えたデバイスで、フェイス ボタンを赤に、センター ライトを青に設定してから、それらのカラーを 1 回の更新で適用します。
サポートされるライティング グループのセットは、デバイス オブジェクトの有効期間中は変化しません。
ライティングのサポートは、デバイスとプラットフォームによって異なります。現在、GameInput は、Windows Dynamic Lighting (LampArray) デバイスと DualSense コントローラーのライトバーでのライティングをサポートしています。

要件

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

関連項目

GameInput の概要
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault

バージョン履歴

最終更新日 2026年11月6日