입력 장치를 나타냅니다. 이 인터페이스의 메서드를 사용하면 게임 입력 장치를 식별하고 상호 작용할 수 있습니다. 해당 유형, 기능 및 배터리 상태와 같은 장치 관련 정보를 쿼리할 수 있습니다. 또한 촉각 및 힘 피드백과 같은 일부 장치 특정 하드웨어를 활성화할 수 있습니다.
구문
class IGameInputDevice : public IUnknown
메서드
| 메서드 | 설명 |
|---|---|
| CreateForceFeedbackEffect | IGameInputForceFeedbackEffect 인터페이스를 활용하여 모터에 대한 힘 피드백 효과를 추적합니다. |
| DirectInputEscape | 하드웨어 관련 명령을 힘 피드백 드라이버에 보냅니다. |
| GetDeviceInfo | 입력 디바이스의 전체 속성 및 기능에 대한 정적 정보를 제공합니다. |
| GetHapticInfo | 입력 디바이스의 전체 촉각 속성 및 기능에 대한 동적 정보를 제공합니다. |
| GetDeviceStatus | 입력 디바이스의 현재 상태 가져옵니다. |
| IsForceFeedbackMotorPoweredOn | 특정 힘 피드백 모터의 전원이 켜지는지 여부를 표시합니다. |
| SetForceFeedbackMotorGain | 모터에 로드된 모든 효과에 대해 전역 감쇠 요소를 설정합니다. |
| SetRumbleState | 디바이스에서 4개의 진동 모터의 원하는 강도를 조정합니다. |
비고
인터페이스를 IGameInputDevice 사용하면 애플리케이션에서 입력 디바이스의 속성, 기능 및 현재 상태에 대한 풍부한 정보에 액세스할 수 있습니다. 또한 힘 피드백 및 촉각 피드백과 같은 고급 기능에 액세스할 수 있습니다. 대부분의 애플리케이션은 이 인터페이스에서 메서드를 호출할 필요가 없으며 입력 스트림에서 판독값을 필터링하기 위한 간단한 디바이스 식별자로만 인스턴스를 사용합니다 IGameInputDevice .
인스턴스와 마찬가지로 IGameInputReading 모든 IGameInputDevice instance 싱글톤입니다. 동일한 디바이스를 여러 번 검색하면 기본 개체에 대한 참조 수가 증가합니다. 따라서 IGameInputDevice 인스턴스를 참조 같음으로 비교할 수 있습니다.
기본 디바이스가 시스템에서 연결이 끊어진 후에도 애플리케이션은 instance 대한 참조 IGameInputDevice 를 계속 유지할 수 있습니다(의도적으로 또는 의도치 않게). 애플리케이션이 IGameInputDevice 인터페이스에 대한 참조를 강제로 해제할 수는 없지만 기본 개체가 좀비 상태가 되므로 instance 유효한 상태로 유지됩니다.
좀비 상태인 경우 정적 구성 정보 또는 디바이스 상태 정보를 반환하는 인터페이스의 IGameInputDevice 모든 메서드는 호출 가능한 상태로 유지됩니다(일반적으로 Get* 메서드). 그러나 디바이스 상태를 수정하거나 어떤 식으로든 디바이스를 연결해야 하는 모든 메서드는 디바이스가 더 이상 연결되지 않았음을 나타내는 오류를 HRESULT 반환합니다. 동일한 물리적 디바이스가 나중에 시스템에 다시 연결되면 좀비 디바이스 개체가 부활하고 instance 모든 메서드 IGameInputDevice 가 다시 작동합니다.
요구 사항
헤더: GameInput.h
지원되는 플랫폼: Windows