메인 콘텐츠로 건너뛰기
입력 장치에 제어 가능한 램프가 있는 조명 그룹을 가져옵니다.

구문

매개변수

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

반환값

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

설명

반환된 값의 각 플래그는 GameInputLightingGroupFaceButtons 또는 GameInputLightingGroupCenterLight와 같이 IGameInputDevice::SetLightingColor로 지정할 수 있는 명명된 램프 그룹을 식별합니다. GameInputLightingGroupUnknown은 값이 0이므로 이 메서드는 이를 그룹으로 보고하지 않습니다. 장치에는 명명된 그룹에 속하지 않는 램프가 있을 수 있습니다. 따라서 반환값이 0이라고 해서 항상 장치에 램프가 없다는 의미는 아닙니다. 장치가 조명을 지원하는지 여부를 확인하려면 IGameInputDevice::GetSupportedInput에 GameInputKindLighting이 포함되어 있는지 확인하거나, GameInputLightingGroupAll을 사용하여 IGameInputDevice::GetSupportedLightingGroupSize를 호출하세요. 명명된 그룹에 속하지 않는 램프 수를 세려면 GameInputLightingGroupUnknown을 사용하여 GetSupportedLightingGroupSize를 호출하세요. 다음 예제는 해당 그룹이 있는 장치에서 페이스 버튼을 빨간색으로, 중앙 조명을 파란색으로 설정한 다음 두 색을 단일 업데이트로 적용합니다.
지원되는 조명 그룹 집합은 장치 개체의 수명 동안 변경되지 않습니다.
조명 지원은 장치와 플랫폼에 따라 다릅니다. 현재 GameInput은 Windows 동적 조명(LampArray) 장치와 DualSense 컨트롤러의 라이트바에서 조명을 지원합니다.

요구 사항

헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInput 개요
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault

버전 기록

마지막 수정일 2026년 11월 6일