XInputSetStateEx
지정된 컨트롤러로 진동 데이터를 보냅니다. 최신 컨트롤러의 4모터 진동 기능을 지원합니다.
구문
DWORD XInputSetStateEx(
DWORD dwUserIndex,
const XINPUT_VIBRATION_EX * pVibration
)
매개 변수
dwUserIndex _In_
형식: DWORD
장치와 연결된 게이머의 색인. 0~XUSER_MAX_COUNT - 1 사이의 값입니다.
pVibration _In_
형식: XINPUT_VIBRATION_EX*
컨트롤러로 보낼 진동 정보를 포함하는 XINPUT_VIBRATION_EX 개체에 대한 포인터입니다.
반환 값
형식: DWORD
함수가 성공하면 ERROR_SUCCESS을(를) 반환합니다.
컨트롤러가 연결되어 있지 않으면 함수가 ERROR_DEVICE_NOT_CONNECTED을(를) 반환합니다.
함수가 실패하면 WinError.h에 정의된 오류 코드를 반환합니다.
설명
2모터 컨트롤러를 조작하는 동안 이 함수를 호출해도 안전합니다. 2모터 컨트롤러의 XInputSetStateEx에 전송되는 진동 설정은 컨트롤러가 계속해서 전송된 입력에 가장 가까운 근사치로 진동하도록 조정됩니다. 이러한 이유로 XInputSetState를 호출하는 상황에서는 XInputSetStateEx을(를) 호출하는 것이 좋습니다.
자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.
요구 사항
헤더: XInputOnGameInput.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔