Skip to main content

XInputGetDeviceId

지정된 컨트롤러의 장치 ID를 검색합니다.

구문

매개변수

dwUserIndex   _In_
형식: DWORD
장치와 연결된 게이머의 인덱스입니다. 값은 0에서 XUSER_MAX_COUNT - 1 범위입니다. pDeviceId   _Out_
형식: APP_LOCAL_DEVICE_ID*
지정된 사용자 인덱스의 장치 ID입니다.

반환값

형식: DWORD 함수가 장치 ID를 성공적으로 검색하면 ERROR_SUCCESS를 반환합니다. 컨트롤러가 연결되어 있지 않으면 함수는 ERROR_DEVICE_NOT_CONNECTED를 반환합니다. 함수가 실패하면 Win32 오류 코드를 반환합니다.

설명

애플리케이션 로컬 장치 ID는 타이틀 또는 시스템의 재시작 후에도 장치를 고유하게 식별합니다. 자세한 내용은 장치 ID를 참조하세요. XInputOnGameInput 사용에 대한 자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.

요구 사항

헤더: XInputOnGameInput.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일