LegacyGipGameControllerProvider.GetDeviceFirmwareCorruptionState Méthode

Référence

Définition

Espace de noms:: Windows.Gaming.Input.Preview

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Récupère l’état indiquant si le microprogramme de l’appareil est endommagé et, le cas échéant, de quelle manière.

public:
 virtual GameControllerFirmwareCorruptReason GetDeviceFirmwareCorruptionState() = GetDeviceFirmwareCorruptionState;

GameControllerFirmwareCorruptReason GetDeviceFirmwareCorruptionState();

public GameControllerFirmwareCorruptReason GetDeviceFirmwareCorruptionState();

function getDeviceFirmwareCorruptionState()

Public Function GetDeviceFirmwareCorruptionState () As GameControllerFirmwareCorruptReason

Retours

GameControllerFirmwareCorruptReason

État indiquant si le microprogramme de l’appareil est endommagé et, le cas échéant, de quelle manière.

Exemples

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

Remarques

Cela doit être utilisé plutôt que IsFirmwareCorrupted pour la plupart des appareils, car il est pris en charge par la plupart des appareils. IsFirmwareCorrupted est uniquement pris en charge par les appareils plus anciens et ne doit être utilisé que si GetDeviceFirmwareCorruptionState n’est pas pris en charge.

Attention

Pour éviter d’endommager les appareils, les API de mise à jour et d’altération du microprogramme ne doivent être utilisées qu’avec le matériel que vous avez développé.

S’applique à

Voir aussi

GameControllerFirmwareCorruptReason

Partager via