LegacyGipGameControllerProvider.IsPilot(User, String) Methode

Definition

Namespace:

Windows.Gaming.Input.Preview

Ruft die ID des Copilot-Controllers ab, wenn dieser Controller ein Pilot ist.

public:
 static Platform::String ^ IsPilot(User ^ user, Platform::String ^ controllerProviderId);

 static winrt::hstring IsPilot(User const& user, winrt::hstring const& controllerProviderId);

public static string IsPilot(User user, string controllerProviderId);

function isPilot(user, controllerProviderId)

Public Shared Function IsPilot (user As User, controllerProviderId As String) As String

Parameter

user

User

Benutzer, auf den die Kopplung überprüft werden soll.

controllerProviderId

String

Platform::String

winrt::hstring

Anbieter-ID für den Controller, der auf Kopplungen überprüft werden soll.

Gibt zurück

String

Platform::String

winrt::hstring

Die ID des Copilot-Controllers, wenn dieser Controller ein Pilot ist; andernfalls NULL.

Beispiele

public void CopilotSample(GipGameControllerProvider pilotProvider,
                                    GipGameControllerProvider copilotProvider)
{
    // Establish a copilot pairing for the given pilot and copilot providers
    string pilotId = GameControllerProviderInfo.GetProviderId(pilotProvider);
    string copilotId = GameControllerProviderInfo.GetProviderId(copilotProvider);
    User user = User.GetDefault();
    LegacyGipGameControllerProvider.PairPilotToCopilot(user, pilotId,
        copilotId);

    // Read copilot properties
    LegacyGipGameControllerProvider.IsPilot(user, pilotId); // Returns copilotId
    LegacyGipGameControllerProvider.IsPilot(user, copilotId); // Returns null
    LegacyGipGameControllerProvider.IsCopilot(user, pilotId); // Returns null
    LegacyGipGameControllerProvider.IsCopilot(user, copilotId); // Returns pilotId

    // Removes the pairing for both controllers
    LegacyGipGameControllerProvider.ClearPairing(user, pilotId);
    // Also removes the pairing for both controllers (unnecessary since the pairing was already removed)
    LegacyGipGameControllerProvider.ClearPairing(user, copilotId);
}