構文
パラメーター
このメソッドにはパラメーターがありません。戻り値
型: 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
