In computing,DirectInput is a legacy[1]MicrosoftAPI for collecting input from a computer user, viainput devices such as themouse,keyboard, or agamepad. It also provides a system foraction mapping, which allows the user to assign specific actions within a game to the buttons and axes of the input devices. Additionally it handleshaptic feedback (input/output) devices. Microsoft introduced a new input library called XInput specifically for theXbox 360 controller.
DirectInput and XInput provide benefits over normal Win32 input events:
While DirectInput forms a part of theDirectX library, it has not been significantly revised since DirectX 8 (2001–2002). Microsoft recommends that new applications make use of theWindows message loop for keyboard and mouse input instead of DirectInput (as indicated in the Meltdown 2005 slideshow[2]), and to use GameInput instead of DirectInput and other legacy APIs, such as XInput, for controllers.[3]
DirectX included DirectInput from version 1.0 (1995). It initially offered true support only for joysticks, as the mouse and keyboard modules simply providedwrappers to the standardWin32 API. DirectX version 3.0 (1996) added support for keyboards and mice; it also improved joystick support. DirectX 5.0 (1997) included greatly improved joystick support, including adding haptic feedback, increasing the number of buttons, changing the underlying device-driver model and incorporating aCOM-basedAPI. Mouse support also increased the number of buttons seen from four to eight. In DirectX 7.0 (1999- ), DirectInput added a long-promised feature of seeing individual mice much like individual joysticks, but the feature didn't work with the later releasedWindows XP, even though as of 2010[update] it works with Windows 98/Me and DirectX 9. DirectX 8.0 (2000), the last version with major changes, included action mapping and broader support for different types of devices.
While Microsoft initially intended that DirectInput would handle all inputs, this didn't work out. As of 2011[update] Microsoft no longer recommends using DirectInput for keyboards or mice, and has started pushing the newer XInput for Xbox 360 controllers.[4] InWindows Vista,Windows 7 and later Windows versions, the in-built action mapping UI has been removed.[5] DirectInput is not available for Windows Store apps.
XInput,[6] a legacy[7]API for "next generation" controllers, was introduced in December 2005 alongside the launch of theXbox 360. This specification provided support for Xbox 360 controllers inWindows XP SP1 and subsequent operating systems, and is described by Microsoft as being easier to program for and requiring less setup than DirectInput. XInput is compatible withDirectX version 9 and later.
AnXbox 360 Controller, with the default Microsoft driver, has the following limitations with DirectInput, compared to XInput:[8]
According toMSDN, "the combination of the left and right triggers in DirectInput is by design. Games have always assumed that DirectInput device axes are centered when there is no user interaction with the device. However, the Xbox 360 controller was designed to register minimum value, not center, when the triggers are not being held." MSDN proffered the "solution" of combining the triggers, setting one trigger to a positive direction and the other to a negative direction, so no user interaction is indicative to DirectInput of the "control" being at center.[10]
The above, however, ignores the fact that many DirectInput controllers, such asgamepads with dual analog sticks andracing-wheel controller sets, already map triggers andpedals independently. In addition, many DirectInput devices also have vibration effects. At least one 3rd-party driver, XBCD, gives the Xbox 360 controllers the vibration support, dead zones and (optionally) independent analog/digital triggers through DirectInput its XInput driver possesses.[11] This suggests that Microsoft's Xbox 360 controller driver was givenintentionally weaker DirectInput support, rather than due to any differences between DirectInput and XInput APIs. On the other hand, Xbox 360 controllers using XInput support only very basic control of vibration motors[12][13] in contrast with greater palette of effects supported via DirectInput.[14]
{{cite web}}: CS1 maint: bot: original URL status unknown (link)GameInput is the recommended API for all new code, regardless of the target platform, because it provides support across all Microsoft platforms (including earlier versions of Windows), and provides superior performance versus legacy APIs.