GameControllerFirmwareCorruptReason Enumerazione

Riferimento

Definizione

Spazio dei nomi:: Windows.Gaming.Input.Preview

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Stato del danneggiamento del firmware per un dispositivo.

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

Ereditarietà: Enum
GameControllerFirmwareCorruptReason

Attributi: ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows Desktop Extension SDK (è stato introdotto in 10.0.23665.0)
API contract	Windows.Gaming.Input.GamingInputPreviewContract (è stato introdotto in v2.0)

Campi

Nome	Valore	Descrizione
AppCorrupt	3	Il firmware dell'app è danneggiato.
EepromCorrupt	5	EEPROM è danneggiato.
NotCorrupt	1	Il firmware non è danneggiato.
RadioCorrupt	4	Il firmware di radio è danneggiato.
SafeToUpdate	6	Il firmware può essere aggiornato in modo sicuro per ripristinare il danneggiamento.
TwoUpCorrupt	2	Il firmware 2Up è danneggiato.
Unknown	0	Non è noto se il firmware è danneggiato.

Esempio

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

Commenti

Attenzione

Per evitare danni ai dispositivi, i danneggiamenti del firmware e le API di aggiornamento devono essere usati solo con l'hardware sviluppato.

Si applica a

Condividi tramite