입력 장치를 나타냅니다. 이 인터페이스의 메서드를 사용하면 게임 입력 장치를 식별하고 상호 작용할 수 있습니다. 해당 유형, 기능 및 배터리 상태와 같은 장치 관련 정보를 쿼리할 수 있습니다. 또한 촉각 및 힘 피드백과 같은 일부 장치 특정 하드웨어를 활성화할 수 있습니다. 이러한 메서드를 사용하면 장치에 대한 단독 액세스 권한을 얻을 수도 있습니다.
구문
class IGameInputDevice : public IUnknown
메서드
| 메서드 | 설명 |
|---|---|
| AcquireExclusiveRawDeviceAccess | IGameInputDevice AcquireExclusiveRawDeviceAccess API 참조 |
| CreateForceFeedbackEffect | 모터에 작용하는 힘 피드백 효과를 추적하기 위해 IGameInputForceFeedbackEffect 인터페이스를 사용합니다. |
| CreateRawDeviceReport | IGameInputRawDeviceReport 인스턴스로 표시된 새 버퍼를 만듭니다. |
| ExecuteRawDeviceIoControl | IOCTL을 기본 장치 또는 해당 드라이버로 보냅니다. |
| GetBatteryState | 장치의 배터리 상태를 가져옵니다. |
| GetDeviceInfo | 입력 장치의 전체 속성 및 기능에 대한 정적 정보에 액세스합니다. |
| GetDeviceStatus | 입력 장치의 현재 상태를 검색합니다. |
| GetRawDeviceFeature | HID 장치에서 기능 보고서를 쿼리합니다. |
| IsForceFeedbackMotorPoweredOn | 특정 힘 피드백 모터가 켜져 있는지 여부를 나타냅니다. |
| PowerOff | 입력 장치의 전원을 끕니다. |
| ReleaseExclusiveRawDeviceAccess | IGameInputDevice ReleaseExclusiveRawDeviceAccess API 참조 |
| SendInputSynchronizationHint | GameInput API에 대해 이루어진 호출을 분석하여 게임 입력 장치를 사용할 수 있는 시점을 결정합니다. |
| SendRawDeviceOutput | 원시 데이터를 장치로 보냅니다. |
| SetForceFeedbackMotorGain | 모터에 로드된 모든 효과에 전역 감쇠 계수를 적용합니다. |
| SetHapticMotorState | 장치의 촉각 모터로 파형을 보냅니다. |
| SetInputSynchronizationState | IGameInputDevice::SetInputSynchronizationState |
| SetRawDeviceFeature | HID 장치에 기능 보고서를 전송합니다. |
| SetRumbleState | 장치에서 4개의 진동 모터에 대해 원하는 강도를 설정합니다. |
비고
IGameInputDevice 인터페이스는 응용 프로그램이 입력 디바이스의 속성, 기능 및 현재 상태에 관한 다양한 정보에 액세스할 수 있게 해 줍니다. 또한 힘 피드백 및 촉각 피드백은 물론 장치에서 로우 레벨 I/O(예: IOCTL)를 수행하는 기능까지 고급 기능에 대한 액세스를 제공합니다. 많은 응용 프로그램은 이 인터페이스에서 메서드를 호출할 필요가 없으며, 입력 스트림에서 수치를 필터링하기 위한 단순 장치 식별자로 IGameInputDevice 인스턴스만 사용하면 됩니다.
IGameInputReading 인스턴스와 같이, 모든 IGameInputDevice 인스턴스는 싱글톤입니다. 동일한 장치를 여러 번 검색하면 기본 개체에 대한 참조 횟수만 증가합니다. 따라서 IGameInputDevice 인스턴스를 비교하여 참조 일치성을 확인할 수 있습니다.
응용 프로그램은 기본 장치가 시스템에서 연결 해제된 후 IGameInputDevice 인스턴스에 대한 참조를 계속 유지할 수 있습니다(의도적 또는 비의도적). 응용 프로그램이 인터페이스에 해당 참조를 릴리스하도록 강제할 수 없지만, 기본 개체가 좀비 상태로 전환되기 때문에 IGameInputDevice 인스턴스는 유효한 상태로 유지됩니다.
좀비 상태에서는 정적 구성 정보 또는 장치 상태 정보를 반환하는 IGameInputDevice 인터페이스에 대한 모든 메서드가 호출 가능한 상태로 유지됩니다(일반적으로 Get* 메서드). 하지만 장치 상태를 수정하거나 어떤 방식으로든 장치 연결이 필요한 모든 메서드는 오류 HRESULT를 반환하며, 장치가 더 이상 연결되지 않았음을 나타냅니다. 동일한 물리적 장치를 나중에 시스템에 다시 연결하면 종비 장치 개체가 부활하고 IGameInputDevice 인스턴스의 모든 메서드가 다시 작동합니다.
요구 사항
헤더: GameInput.h
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔