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

# XInputGetCapabilities

> XInputGetCapabilities

# XInputGetCapabilities

연결된 컨트롤러의 기능과 특성을 검색합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
DWORD XInputGetCapabilities(  
         DWORD dwUserIndex,  
         DWORD dwFlags,  
         XINPUT_CAPABILITIES * pCapabilities  
)  
```

<a id="parametersSection" />

### 매개변수

*dwUserIndex*   \_In\_\
형식: DWORD

장치와 연결된 게이머의 인덱스입니다. 값은 0에서 `XUSER_MAX_COUNT - 1` 범위입니다.

*dwFlags*   \_In\_\
형식: DWORD

컨트롤러 유형을 식별하는 입력 플래그입니다. 이 값이 0이면 시스템에 연결된 모든 컨트롤러의 기능이 반환됩니다. 현재는 `XINPUT_FLAG_GAMEPAD`만 지원됩니다.

*pCapabilities*   \_Out\_\
형식: [XINPUT\_CAPABILITIES](/reference/input/xinputongameinput/structs/xinput_capabilities)\*

컨트롤러 기능을 받는 [XINPUT\_CAPABILITIES](/reference/input/xinputongameinput/structs/xinput_capabilities) 객체에 대한 포인터입니다.

<a id="retvalSection" />

### 반환값

형식: DWORD

함수가 성공하면 반환값은 `ERROR_SUCCESS`입니다.

컨트롤러가 연결되어 있지 않으면 반환값은 `ERROR_DEVICE_NOT_CONNECTED`입니다.

함수가 실패하면 반환값은 WinError.h에 정의된 오류 코드입니다. 함수는 호출 스레드의 마지막 오류 코드를 설정하기 위해 `SetLastError`를 사용하지 않습니다.

<a id="remarksSection" />

## 설명

<Note>레거시 XINPUT 9.1.0 버전(Windows Vista 이상 포함)은 연결된 장치와 관계없이 항상 고정된 기능 집합을 반환했습니다.</Note>

보고되는 기능에 대한 자세한 내용은 [XINPUT\_CAPABILITIES](/reference/input/xinputongameinput/structs/xinput_capabilities)를 참조하세요.

자세한 내용은 [XInputOnGameInput 래퍼](/build/core-features/common/input/porting/input-porting-xinput#xinputWrapperSection)를 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** XInputOnGameInput.h

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

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

<a id="seealsoSection" />

## 참고 항목

[XInput에서 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_CAPABILITIES](/ko/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputOnGameInput](/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [GameInputDeviceCapabilities](/ko/reference/input/gameinput/deprecated/enums/gameinputdevicecapabilities.md)
- [GetDeviceInfo](/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md)
- [GameInput](/ko/reference/input/gameinput/gameinput_members.md)