> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputDevice::GetSupportedLightingGroups

> 입력 장치에 제어 가능한 램프가 있는 조명 그룹을 가져옵니다.

입력 장치에 제어 가능한 램프가 있는 조명 그룹을 가져옵니다.

## 구문

```cpp theme={null}
GameInputLightingGroups GetSupportedLightingGroups();
```

### 매개변수

이 메서드에는 매개변수가 없습니다.

### 반환값

형식: [GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)

장치에 램프가 하나 이상 포함된 모든 명명된 조명 그룹에 대한 `GameInputLightingGroups` 플래그의 조합입니다. 장치에 명명된 그룹의 램프가 없으면 `GameInputLightingGroupUnknown`(0)을 반환합니다.

## 설명

반환된 값의 각 플래그는 `GameInputLightingGroupFaceButtons` 또는 `GameInputLightingGroupCenterLight`와 같이 [IGameInputDevice::SetLightingColor](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)로 지정할 수 있는 명명된 램프 그룹을 식별합니다. `GameInputLightingGroupUnknown`은 값이 0이므로 이 메서드는 이를 그룹으로 보고하지 않습니다.

장치에는 명명된 그룹에 속하지 않는 램프가 있을 수 있습니다. 따라서 반환값이 0이라고 해서 항상 장치에 램프가 없다는 의미는 아닙니다. 장치가 조명을 지원하는지 여부를 확인하려면 [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)에 `GameInputKindLighting`이 포함되어 있는지 확인하거나, `GameInputLightingGroupAll`을 사용하여 [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)를 호출하세요. 명명된 그룹에 속하지 않는 램프 수를 세려면 `GameInputLightingGroupUnknown`을 사용하여 `GetSupportedLightingGroupSize`를 호출하세요.

다음 예제는 해당 그룹이 있는 장치에서 페이스 버튼을 빨간색으로, 중앙 조명을 파란색으로 설정한 다음 두 색을 단일 업데이트로 적용합니다.

```cpp theme={null}
void SetControllerLighting(IGameInputDevice* device) noexcept
{
    const GameInputLightingGroups groups = device->GetSupportedLightingGroups();

    if ((groups & GameInputLightingGroupFaceButtons) != 0)
    {
        device->SetLightingColor({ 255, 0, 0 }, GameInputLightingGroupFaceButtons);
    }

    if ((groups & GameInputLightingGroupCenterLight) != 0)
    {
        device->SetLightingColor({ 0, 0, 255 }, GameInputLightingGroupCenterLight);
    }

    device->ApplyLightingColors();
}
```

지원되는 조명 그룹 집합은 장치 개체의 수명 동안 변경되지 않습니다.

> [!NOTE]
>
> 조명 지원은 장치와 플랫폼에 따라 다릅니다. 현재 GameInput은 Windows 동적 조명(LampArray) 장치와 DualSense 컨트롤러의 라이트바에서 조명을 지원합니다.

## 요구 사항

**헤더:** GameInput.h

**라이브러리:** gameinput.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)\
[IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)\
[IGameInputDevice::SetLightingColor](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)\
[IGameInputDevice::ApplyLightingColors](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md)\
[IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v4** | 도입됨. |


## Related topics

- [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)
- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)
- [IGameInputDevice::ApplyLightingColors](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md)
- [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)
- [IGameInputDevice::GetDeviceFamily](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicefamily.md)