> ## 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.

# XFrontPanelGetLightStates

> XFrontPanelGetLightStates

# XFrontPanelGetLightStates

프런트 패널 라이트의 상태를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XFrontPanelGetLightStates(  
         XFrontPanelLight* lights  
)  
```

### 매개 변수

*lights*   \_Out\_\
형식: [XFrontPanelLight](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/enums/xfrontpanellight.md)\*

프런트 패널 라이트의 현재 상태를 나타내는 값에 대한 포인터입니다.

### 반환 값

형식: HRESULT

성공하면 `S_OK`를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

## 설명

XBOX One X 개발 키트의 프런트 패널에는 프로그래밍 가능한 5개의 버튼에 해당하는 5개의 라이트가 포함되어 있습니다.

![XBOX One X의 프런트 패널 디스플레이](https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/front_panel_display_small.png?fit=max\&auto=format\&n=-_0FrcE2bDxzGxv-\&q=85\&s=8c81bf256714cec6526e83a4cbac5538)

*lights* 매개 변수는 각 라이트의 상태를 나타내는 [XFrontPanelLight](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/enums/xfrontpanellight.md) 개체를 가리킵니다.

프런트 패널 라이트의 상태를 설정하려면 [XFrontPanelSetLightStates](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelsetlightstates.md)를 사용합니다.

자세한 내용은 [XBOX One X: 프런트 패널 디스플레이 사용(NDA 항목)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/dev-kits/concepts/scorpio-frontpanel)을 참조하세요.

## 요구 사항

**헤더:** xfrontpaneldisplay.h

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

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

## 함께 보기

[XFrontPanelDisplay](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)


## Related topics

- [XFrontPanelLight](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/enums/xfrontpanellight.md)
- [XFrontPanelSetLightStates](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelsetlightstates.md)
- [XFrontPanelDisplay(API 콘텐츠)](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)
- [XFrontPanelGetButtonStates](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetbuttonstates.md)
- [XFrontPanelButton](https://docs.xbox.com/ko/reference/devkit/xfrontpaneldisplay/enums/xfrontpanelbutton.md)