You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
283 lines
8.8 KiB
283 lines
8.8 KiB
/***************************************************************************
|
|
* *
|
|
* XInput.h -- This module defines XBOX controller APIs *
|
|
* and constansts for the Windows platform. *
|
|
* *
|
|
* Copyright (c) Microsoft Corp. All rights reserved. *
|
|
* *
|
|
***************************************************************************/
|
|
#ifndef _XINPUT_H_
|
|
#define _XINPUT_H_
|
|
|
|
#include <windef.h>
|
|
|
|
// Current name of the DLL shipped in the same SDK as this header.
|
|
// The name reflects the current version
|
|
#ifndef XINPUT_USE_9_1_0
|
|
#define XINPUT_DLL_A "xinput1_3.dll"
|
|
#define XINPUT_DLL_W L"xinput1_3.dll"
|
|
#else
|
|
#define XINPUT_DLL_A "xinput9_1_0.dll"
|
|
#define XINPUT_DLL_W L"xinput9_1_0.dll"
|
|
#endif
|
|
#ifdef UNICODE
|
|
#define XINPUT_DLL XINPUT_DLL_W
|
|
#else
|
|
#define XINPUT_DLL XINPUT_DLL_A
|
|
#endif
|
|
|
|
//
|
|
// Device types available in XINPUT_CAPABILITIES
|
|
//
|
|
#define XINPUT_DEVTYPE_GAMEPAD 0x01
|
|
|
|
//
|
|
// Device subtypes available in XINPUT_CAPABILITIES
|
|
//
|
|
#define XINPUT_DEVSUBTYPE_GAMEPAD 0x01
|
|
|
|
#ifndef XINPUT_USE_9_1_0
|
|
|
|
#define XINPUT_DEVSUBTYPE_WHEEL 0x02
|
|
#define XINPUT_DEVSUBTYPE_ARCADE_STICK 0x03
|
|
#define XINPUT_DEVSUBTYPE_FLIGHT_SICK 0x04
|
|
#define XINPUT_DEVSUBTYPE_DANCE_PAD 0x05
|
|
#define XINPUT_DEVSUBTYPE_GUITAR 0x06
|
|
#define XINPUT_DEVSUBTYPE_DRUM_KIT 0x08
|
|
|
|
#endif // !XINPUT_USE_9_1_0
|
|
|
|
|
|
|
|
//
|
|
// Flags for XINPUT_CAPABILITIES
|
|
//
|
|
#define XINPUT_CAPS_VOICE_SUPPORTED 0x0004
|
|
|
|
//
|
|
// Constants for gamepad buttons
|
|
//
|
|
#define XINPUT_GAMEPAD_DPAD_UP 0x0001
|
|
#define XINPUT_GAMEPAD_DPAD_DOWN 0x0002
|
|
#define XINPUT_GAMEPAD_DPAD_LEFT 0x0004
|
|
#define XINPUT_GAMEPAD_DPAD_RIGHT 0x0008
|
|
#define XINPUT_GAMEPAD_START 0x0010
|
|
#define XINPUT_GAMEPAD_BACK 0x0020
|
|
#define XINPUT_GAMEPAD_LEFT_THUMB 0x0040
|
|
#define XINPUT_GAMEPAD_RIGHT_THUMB 0x0080
|
|
#define XINPUT_GAMEPAD_LEFT_SHOULDER 0x0100
|
|
#define XINPUT_GAMEPAD_RIGHT_SHOULDER 0x0200
|
|
#define XINPUT_GAMEPAD_A 0x1000
|
|
#define XINPUT_GAMEPAD_B 0x2000
|
|
#define XINPUT_GAMEPAD_X 0x4000
|
|
#define XINPUT_GAMEPAD_Y 0x8000
|
|
|
|
|
|
//
|
|
// Gamepad thresholds
|
|
//
|
|
#define XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE 7849
|
|
#define XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE 8689
|
|
#define XINPUT_GAMEPAD_TRIGGER_THRESHOLD 30
|
|
|
|
//
|
|
// Flags to pass to XInputGetCapabilities
|
|
//
|
|
#define XINPUT_FLAG_GAMEPAD 0x00000001
|
|
|
|
|
|
#ifndef XINPUT_USE_9_1_0
|
|
|
|
//
|
|
// Devices that support batteries
|
|
//
|
|
#define BATTERY_DEVTYPE_GAMEPAD 0x00
|
|
#define BATTERY_DEVTYPE_HEADSET 0x01
|
|
|
|
//
|
|
// Flags for battery status level
|
|
//
|
|
#define BATTERY_TYPE_DISCONNECTED 0x00 // This device is not connected
|
|
#define BATTERY_TYPE_WIRED 0x01 // Wired device, no battery
|
|
#define BATTERY_TYPE_ALKALINE 0x02 // Alkaline battery source
|
|
#define BATTERY_TYPE_NIMH 0x03 // Nickel Metal Hydride battery source
|
|
#define BATTERY_TYPE_UNKNOWN 0xFF // Cannot determine the battery type
|
|
|
|
// These are only valid for wireless, connected devices, with known battery types
|
|
// The amount of use time remaining depends on the type of device.
|
|
#define BATTERY_LEVEL_EMPTY 0x00
|
|
#define BATTERY_LEVEL_LOW 0x01
|
|
#define BATTERY_LEVEL_MEDIUM 0x02
|
|
#define BATTERY_LEVEL_FULL 0x03
|
|
|
|
// User index definitions
|
|
#define XUSER_MAX_COUNT 4
|
|
|
|
#define XUSER_INDEX_ANY 0x000000FF
|
|
|
|
|
|
//
|
|
// Codes returned for the gamepad keystroke
|
|
//
|
|
|
|
#define VK_PAD_A 0x5800
|
|
#define VK_PAD_B 0x5801
|
|
#define VK_PAD_X 0x5802
|
|
#define VK_PAD_Y 0x5803
|
|
#define VK_PAD_RSHOULDER 0x5804
|
|
#define VK_PAD_LSHOULDER 0x5805
|
|
#define VK_PAD_LTRIGGER 0x5806
|
|
#define VK_PAD_RTRIGGER 0x5807
|
|
|
|
#define VK_PAD_DPAD_UP 0x5810
|
|
#define VK_PAD_DPAD_DOWN 0x5811
|
|
#define VK_PAD_DPAD_LEFT 0x5812
|
|
#define VK_PAD_DPAD_RIGHT 0x5813
|
|
#define VK_PAD_START 0x5814
|
|
#define VK_PAD_BACK 0x5815
|
|
#define VK_PAD_LTHUMB_PRESS 0x5816
|
|
#define VK_PAD_RTHUMB_PRESS 0x5817
|
|
|
|
#define VK_PAD_LTHUMB_UP 0x5820
|
|
#define VK_PAD_LTHUMB_DOWN 0x5821
|
|
#define VK_PAD_LTHUMB_RIGHT 0x5822
|
|
#define VK_PAD_LTHUMB_LEFT 0x5823
|
|
#define VK_PAD_LTHUMB_UPLEFT 0x5824
|
|
#define VK_PAD_LTHUMB_UPRIGHT 0x5825
|
|
#define VK_PAD_LTHUMB_DOWNRIGHT 0x5826
|
|
#define VK_PAD_LTHUMB_DOWNLEFT 0x5827
|
|
|
|
#define VK_PAD_RTHUMB_UP 0x5830
|
|
#define VK_PAD_RTHUMB_DOWN 0x5831
|
|
#define VK_PAD_RTHUMB_RIGHT 0x5832
|
|
#define VK_PAD_RTHUMB_LEFT 0x5833
|
|
#define VK_PAD_RTHUMB_UPLEFT 0x5834
|
|
#define VK_PAD_RTHUMB_UPRIGHT 0x5835
|
|
#define VK_PAD_RTHUMB_DOWNRIGHT 0x5836
|
|
#define VK_PAD_RTHUMB_DOWNLEFT 0x5837
|
|
|
|
//
|
|
// Flags used in XINPUT_KEYSTROKE
|
|
//
|
|
#define XINPUT_KEYSTROKE_KEYDOWN 0x0001
|
|
#define XINPUT_KEYSTROKE_KEYUP 0x0002
|
|
#define XINPUT_KEYSTROKE_REPEAT 0x0004
|
|
|
|
#endif //!XINPUT_USE_9_1_0
|
|
|
|
//
|
|
// Structures used by XInput APIs
|
|
//
|
|
typedef struct _XINPUT_GAMEPAD
|
|
{
|
|
WORD wButtons;
|
|
BYTE bLeftTrigger;
|
|
BYTE bRightTrigger;
|
|
SHORT sThumbLX;
|
|
SHORT sThumbLY;
|
|
SHORT sThumbRX;
|
|
SHORT sThumbRY;
|
|
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;
|
|
|
|
typedef struct _XINPUT_STATE
|
|
{
|
|
DWORD dwPacketNumber;
|
|
XINPUT_GAMEPAD Gamepad;
|
|
} XINPUT_STATE, *PXINPUT_STATE;
|
|
|
|
typedef struct _XINPUT_VIBRATION
|
|
{
|
|
WORD wLeftMotorSpeed;
|
|
WORD wRightMotorSpeed;
|
|
} XINPUT_VIBRATION, *PXINPUT_VIBRATION;
|
|
|
|
typedef struct _XINPUT_CAPABILITIES
|
|
{
|
|
BYTE Type;
|
|
BYTE SubType;
|
|
WORD Flags;
|
|
XINPUT_GAMEPAD Gamepad;
|
|
XINPUT_VIBRATION Vibration;
|
|
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;
|
|
|
|
#ifndef XINPUT_USE_9_1_0
|
|
|
|
typedef struct _XINPUT_BATTERY_INFORMATION
|
|
{
|
|
BYTE BatteryType;
|
|
BYTE BatteryLevel;
|
|
} XINPUT_BATTERY_INFORMATION, *PXINPUT_BATTERY_INFORMATION;
|
|
|
|
typedef struct _XINPUT_KEYSTROKE
|
|
{
|
|
WORD VirtualKey;
|
|
WCHAR Unicode;
|
|
WORD Flags;
|
|
BYTE UserIndex;
|
|
BYTE HidCode;
|
|
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;
|
|
|
|
#endif // !XINPUT_USE_9_1_0
|
|
|
|
//
|
|
// XInput APIs
|
|
//
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
DWORD WINAPI XInputGetState
|
|
(
|
|
__in DWORD dwUserIndex, // Index of the gamer associated with the device
|
|
__out XINPUT_STATE* pState // Receives the current state
|
|
);
|
|
|
|
DWORD WINAPI XInputSetState
|
|
(
|
|
__in DWORD dwUserIndex, // Index of the gamer associated with the device
|
|
__in XINPUT_VIBRATION* pVibration // The vibration information to send to the controller
|
|
);
|
|
|
|
DWORD WINAPI XInputGetCapabilities
|
|
(
|
|
__in DWORD dwUserIndex, // Index of the gamer associated with the device
|
|
__in DWORD dwFlags, // Input flags that identify the device type
|
|
__out XINPUT_CAPABILITIES* pCapabilities // Receives the capabilities
|
|
);
|
|
|
|
void WINAPI XInputEnable
|
|
(
|
|
__in BOOL enable // [in] Indicates whether xinput is enabled or disabled.
|
|
);
|
|
|
|
DWORD WINAPI XInputGetDSoundAudioDeviceGuids
|
|
(
|
|
__in DWORD dwUserIndex, // Index of the gamer associated with the device
|
|
__out GUID* pDSoundRenderGuid, // DSound device ID for render
|
|
__out GUID* pDSoundCaptureGuid // DSound device ID for capture
|
|
);
|
|
|
|
#ifndef XINPUT_USE_9_1_0
|
|
|
|
DWORD WINAPI XInputGetBatteryInformation
|
|
(
|
|
__in DWORD dwUserIndex, // Index of the gamer associated with the device
|
|
__in BYTE devType, // Which device on this user index
|
|
__out XINPUT_BATTERY_INFORMATION* pBatteryInformation // Contains the level and types of batteries
|
|
);
|
|
|
|
DWORD WINAPI XInputGetKeystroke
|
|
(
|
|
__in DWORD dwUserIndex, // Index of the gamer associated with the device
|
|
__reserved DWORD dwReserved, // Reserved for future use
|
|
__out PXINPUT_KEYSTROKE pKeystroke // Pointer to an XINPUT_KEYSTROKE structure that receives an input event.
|
|
);
|
|
|
|
#endif //!XINPUT_USE_9_1_0
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif //_XINPUT_H_
|
|
|