LegacyGipGameControllerProvider.GetDeviceFirmwareCorruptionState Methode

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

Ruft den Status ab, ob die Firmware des Geräts beschädigt ist und wenn ja, auf welche Weise.

public:
 virtual GameControllerFirmwareCorruptReason GetDeviceFirmwareCorruptionState() = GetDeviceFirmwareCorruptionState;

GameControllerFirmwareCorruptReason GetDeviceFirmwareCorruptionState();

public GameControllerFirmwareCorruptReason GetDeviceFirmwareCorruptionState();

function getDeviceFirmwareCorruptionState()

Public Function GetDeviceFirmwareCorruptionState () As GameControllerFirmwareCorruptReason

Gibt zurück

GameControllerFirmwareCorruptReason

Der Status, ob die Firmware des Geräts beschädigt ist, und wenn ja, in welcher Weise.

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

Dies sollte anstelle IsFirmwareCorrupted von den meisten Geräten verwendet werden, da es von den meisten Geräten unterstützt wird. IsFirmwareCorrupted wird nur von älteren Geräten unterstützt und sollte nur verwendet werden, wenn GetDeviceFirmwareCorruptionState nicht unterstützt wird.

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:

Weitere Informationen

GameControllerFirmwareCorruptReason

Freigeben über