RawGameController.NonRoamableId Eigenschaft

Definition

Namespace:

Windows.Gaming.Input

Eine eindeutige ID, die den Controller identifiziert. Solange der Controller verbunden ist, ändert sich die ID nie.

public:
 property Platform::String ^ NonRoamableId { Platform::String ^ get(); };

winrt::hstring NonRoamableId();

public string NonRoamableId { get; }

var string = rawGameController.nonRoamableId;

Public ReadOnly Property NonRoamableId As String

Eigenschaftswert

String

Platform::String

winrt::hstring

Eine eindeutige ID, die den Controller identifiziert. Solange der Controller verbunden ist, ändert sich die ID nie.

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Hinweise

Diese ID hat eine längere Lebensdauer als die Anwendung und die Verbindung des Controllers. Es wird garantiert nicht für einen bestimmten Controller geändert, auch zwischen Neustarts des Geräts, mit dem er verbunden ist, solange der Controller an den gleichen USB-Anschluss des Geräts angeschlossen bleibt. Ein Beispiel, bei dem dies nützlich sein könnte, ist für Spiele wie Flugsimulatoren, bei denen der Benutzer mehrere desselben Controllertyps an seinen PC anschließen kann, z. B. Module mit Instrumentenpanels. Wenn der Benutzer diesen Controllern im Spiel Funktionen zuweist, muss das Spiel in der Lage sein, jeden Controller eindeutig zu identifizieren (was nicht über die Produkt- und Anbieter-IDs allein möglich ist), damit sichergestellt werden kann, dass die richtigen Funktionen den richtigen Controllern zugewiesen werden, wenn es das nächste Mal ausgeführt wird.

Diese ID ist auch für die Anwendung auf diesem Gerät eindeutig. Das gleiche Gamepad, das an denselben PC angeschlossen ist, verfügt in zwei verschiedenen Anwendungen über eine andere NonRoamableId . Ebenso verfügt das gleiche Gamepad, das in derselben Anwendung, aber auf verschiedenen PCs ausgeführt wird, über unterschiedliche NonRoamableIDs.