GetDeviceInfo (Deprecated)

Deprecated. This method was removed in GameInput v4 and is not available in the current API. Use the individual getter methods on IGameInputDevice instead, such as GetVendorId and GetRacingWheelInfo. For a mapping of each GameInputDeviceInfo member to its replacement, see the Remarks section of that page.

Accesses static information about the full properties and capabilities of an input device.

Syntax

HRESULT GetDeviceInfo(
    const GameInputDeviceInfo** info
);

Parameters

info _Outptr_
Type: GameInputDeviceInfo** The device info associated with the IGameInputDevice.

Return value

Type: HRESULT Function result.

Remarks

The GetDeviceInfo method memory is not owned by the application. The memory will remain accessible if the IGameInput instance is kept alive by the application. Once the reference to the IGameInput object is released, the memory goes away. The following code example demonstrates how to determine whether a racing wheel has a clutch.

bool HasClutch(IGameInputDevice* wheel) noexcept
{
    const GameInputDeviceInfo* wheelInfo = nullptr;
    const bool succeeded = SUCCEEDED(wheel->GetDeviceInfo(&wheelInfo));
    assert(succeeded);
    assert(wheelInfo->racingWheelInfo);

    const bool hasClutch = wheelInfo->racingWheelInfo->hasClutch;

    return hasClutch;
}

Requirements

Header: GameInput.h

Version History

Version	Changes
v4	Removed.
v3	Signature unchanged. GameInputDeviceInfo extended: `controllerInfo` added (replacing separate axis/button/switch count+info fields and `uiNavigationInfo`); `inputReportCount`/`inputReportInfo` and `outputReportCount`/`outputReportInfo` added; `hapticFeedbackMotorInfo` removed.
v2	Signature unchanged. GameInputDeviceInfo extended with `revisionNumber`, `hardwareVersion`, `firmwareVersion`, `containerId`, and `sensorsInfo`.
v1	Signature unchanged. GameInputDeviceInfo was significantly simplified: `infoSize`, `interfaceNumber`, `collectionNumber`, `capabilities`, touch/haptic/string/descriptor fields removed; `supportedSystemButtons`, `displayName`, and `pnpPath` added.
v0	Introduced.

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Syntax

Parameters

Return value

Remarks

Requirements

See also

Version History

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

​Version History

Syntax

Parameters

Return value

Remarks

Requirements

See also

Version History