LegacyGipGameControllerProvider.IsFirmwareCorrupted 属性

定义

命名空间:

Windows.Gaming.Input.Preview

返回控制器固件是否已损坏。

public:
 property bool IsFirmwareCorrupted { bool get(); };

bool IsFirmwareCorrupted();

public bool IsFirmwareCorrupted { get; }

var boolean = legacyGipGameControllerProvider.isFirmwareCorrupted;

Public ReadOnly Property IsFirmwareCorrupted As Boolean

属性值

Boolean

bool

控制器的电池充电状态。

GetDeviceFirmwareCorruptionState 应使用 而不是 IsFirmwareCorrupted ，因为大多数设备都支持它。 IsFirmwareCorrupted 仅受较旧设备支持，仅当 不支持时 GetDeviceFirmwareCorruptionState ，才应使用 。

注意

为了避免损坏设备，固件损坏和更新 API 应仅用于你开发的硬件。

示例

public void EnumerateControllerProperties()
{
    foreach (Gamepad gamepad in Gamepad.Gamepads)
    {
        // Create the provider
        LegacyGipGameControllerProvider legacyGipGameControllerProvider =
            LegacyGipGameControllerProvider.FromGameController(gamepad);
        if (legacyGipGameControllerProvider == null)
        {
            // Not every gamepad is a legacy GIP game controller, continue enumerating
            continue;
        }

        // Check properties
        GameControllerBatteryChargingState chargeState =
            legacyGipGameControllerProvider.BatteryChargingState;
        GameControllerBatteryKind batteryKind =
            legacyGipGameControllerProvider.BatteryKind;
        GameControllerBatteryLevel batteryLevel =
            legacyGipGameControllerProvider.BatteryLevel;
        bool isOldFirmwareCorrupted =
            legacyGipGameControllerProvider.IsFirmwareCorrupted;
        bool isNewFirmwareCorrupted =
            legacyGipGameControllerProvider.GetDeviceFirmwareCorruptionState()
            != GameControllerFirmwareCorruptReason.NotCorrupt;
        bool isSynthetic = legacyGipGameControllerProvider.IsSyntheticDevice;
        byte[] extendedDeviceInfo = legacyGipGameControllerProvider.GetExtendedDeviceInfo();

        // Check for a particular GIP interface
        bool supportsSomeCustomInterface =
            legacyGipGameControllerProvider.IsInterfaceSupported(
                new Guid(
                    0xaaaaaaaa, 0xbbbb, 0xcccc, 0xe, 0xf, 0x1, 0x2, 0x3, 0x4, 0x5, 0x6));

        IReadOnlyList<string> preferredTypes =
            legacyGipGameControllerProvider.PreferredTypes;
        bool isGamepad = preferredTypes.Contains("Windows.Xbox.Input.Gamepad");
        bool isHeadset = preferredTypes.Contains("Windows.Xbox.Input.Headset");

        // Change the LED to half brightness
        legacyGipGameControllerProvider.SetHomeLedIntensity(50);
    }
}

另请参阅

• GetDeviceFirmwareCorruptionState