LegacyGipGameControllerProvider.IsFirmwareCorrupted Eigenschaft
Definition
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.
Gibt zurück, ob die Controllerfirmware beschädigt ist.
public:
property bool IsFirmwareCorrupted { bool get(); };
bool IsFirmwareCorrupted();
public bool IsFirmwareCorrupted { get; }
var boolean = legacyGipGameControllerProvider.isFirmwareCorrupted;
Public ReadOnly Property IsFirmwareCorrupted As Boolean
Eigenschaftswert
bool
Akkuladezustand des Controllers.
GetDeviceFirmwareCorruptionState
sollte verwendet werden, anstatt IsFirmwareCorrupted
wie 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.
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);
}
}