다음을 통해 공유


GameInputDeviceStatus

입력 장치의 상태 열거형.

구문

typedef enum GameInputDeviceStatus  
{  
    GameInputDeviceNoStatus = 0x00000000,  
    GameInputDeviceConnected = 0x00000001,  
    GameInputDeviceInputEnabled = 0x00000002,  
    GameInputDeviceOutputEnabled = 0x00000004,  
    GameInputDeviceRawIoEnabled = 0x00000008,  
    GameInputDeviceAudioCapture = 0x00000010,  
    GameInputDeviceAudioRender = 0x00000020,  
    GameInputDeviceSynchronized = 0x00000040,  
    GameInputDeviceWireless = 0x00000080,  
    GameInputDeviceUserIdle = 0x00100000,  
    GameInputDeviceAnyStatus = 0x00FFFFFF  
} GameInputDeviceStatus  

상수

상수 설명
GameInputDeviceNoStatus 장치에 상태가 없습니다.
GameInputDeviceConnected 장치가 연결되어 있습니다.
GameInputDeviceInputEnabled 장치가 입력을 받을 수 있도록 활성화되어 있습니다.
GameInputDeviceOutputEnabled GameInput 장치를 출력을 전송할 수 있도록 활성화되어 있습니다.
GameInputDeviceRawIoEnabled 장치가 원시 출력을 게임으로 전송할 수 있도록 활성화되어 있습니다.
GameInputDeviceAudioCapture 장치에 오디오 캡처 기능이 있습니다.
GameInputDeviceAudioRender 장치에 오디오 렌더링 기능이 있습니다.
GameInputDeviceSynchronized 장치에 입력 동기화 기능이 있습니다.
GameInputDeviceWireless 장치가 무선이며 장치에 연결되어 있습니다.
GameInputDeviceUserIdle 장치가 유휴 상태입니다.
GameInputDeviceAnyStatus 모든 장치 상태에 대해 true로 읽습니다.

비고

이러한 플래그 값은 한 번에 둘 이상의 장치를 필터링하기 위해 필요에 따라 조합할 수 있습니다.
iGameInputDevice_GetDeviceStatus에서 반환됩니다.

GameInputDeviceInputEnabled 플래그는 호출 프로세스가 현재 입력 장치에서 입력을 받고 있는지 여부를 나타냅니다. 일부 특별한 경우, 오버레이 UI가 일시적으로 프로세스에서 입력을 가로챌 수 있습니다. 이 경우 여전히 프로세스에 입력 포커스가 있지만 “입력 활성화” 플래그가 설정되지 않습니다. 이 플래그가 설정되지 않으면 장치에서 읽은 최근 입력이 중립 또는 “휴면” 상태(즉, 버튼을 누르지 않았거나 움직임이 없음)임을 의미합니다.

GameInputDeviceOutputEnabled 플래그는 힘, 햅틱 또는 진동 피드백이 현재 장치로 전송되고 있는지 여부를 나타냅니다. 프로세스는 언제든지 (심지어 백그라운드에서도) 이러한 유형의 피드백에 대한 상태를 설정할 수 있습니다. 그러나 프로세스에 입력 포커스가 있고 현재 독점 원시 장치 I/O(이 문서 뒷부분에서 설명)를 수행하는 다른 프로세스가 없을 때만 출력이 장치로 전송됩니다.

GameInputDeviceRawIoEnabled 플래그는 원시 장치 I/O를 장치로 보낼 수 있는지 여부를 나타냅니다. 이 플래그는 프로세스에 입력 포커스가 있고 현재 독점 원시 장치 I/O(이 문서 뒷부분에서 설명)를 수행하는 다른 응용 프로그램이 없을 때 설정됩니다. 프로세스가 독점적인 원시 장치 I/O 액세스를 취득했을 때도 설정됩니다.

GameInputDeviceUserIdle 플래그는 최소 20초 동안 장치로부터 사용자가 생성한 입력을 수신하지 않았음을 나타냅니다. 이는 응용 프로그램에서 게임을 일시 중지하거나 프레임 속도를 낮춰 배터리 충전량을 절약하는 등의 다양한 용도로 사용할 수 있습니다.

응용 프로그램은 IGameInput 인터페이스IGameInput::RegisterDeviceCallback 메서드를 통해 이러한 상태 변경이 수행되면 콜백을 수신하도록 등록할 수 있습니다.

요구 사항

헤더: GameInput.h

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

입력 API 개요
GameInput
IGameInput::RegisterDeviceCallback