GameControllerFirmwareCorruptReason Enumeration

Referenz

Definition

Namespace:: Windows.Gaming.Input.Preview

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Der Zustand der Firmwarebeschädigung für ein Gerät.

public enum class GameControllerFirmwareCorruptReason

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Gaming.Input.GamingInputPreviewContract, 131072)]
enum class GameControllerFirmwareCorruptReason

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Gaming.Input.GamingInputPreviewContract), 131072)]
public enum GameControllerFirmwareCorruptReason

var value = Windows.Gaming.Input.Preview.GameControllerFirmwareCorruptReason.unknown

Public Enum GameControllerFirmwareCorruptReason

Vererbung: Enum
GameControllerFirmwareCorruptReason

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows Desktop Extension SDK (eingeführt in 10.0.23665.0)
API contract	Windows.Gaming.Input.GamingInputPreviewContract (eingeführt in v2.0)

Felder

AppCorrupt	3	Die App-Firmware ist beschädigt.
EepromCorrupt	5	Das EEPROM ist beschädigt.
NotCorrupt	1	Die Firmware ist nicht beschädigt.
RadioCorrupt	4	Die Funkfirmware ist beschädigt.
SafeToUpdate	6	Die Firmware kann sicher aktualisiert werden, um eine Beschädigung wiederherzustellen.
TwoUpCorrupt	2	Die 2Up-Firmware ist beschädigt.
Unknown	0	Es ist nicht bekannt, ob die Firmware beschädigt ist.

Beispiele

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);
    }
}

Hinweise

Achtung

Um Beschädigungen von Geräten zu vermeiden, sollten die Firmwarebeschädigungs- und Update-APIs nur mit von Ihnen entwickelter Hardware verwendet werden.

Gilt für:

Freigeben über