BluetoothLEDevice.RequestPreferredConnectionParameters Methode

Referenz

Definition

Namespace:: Windows.Devices.Bluetooth

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 ein Anforderungsobjekt der bevorzugten Bluetooth LE-Verbindungsparameter für das angegebene bevorzugte Bluetooth LE-Verbindungsparameterobjekt ab.

public:
 virtual BluetoothLEPreferredConnectionParametersRequest ^ RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters ^ preferredConnectionParameters) = RequestPreferredConnectionParameters;

BluetoothLEPreferredConnectionParametersRequest RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters const& preferredConnectionParameters);

public BluetoothLEPreferredConnectionParametersRequest RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters preferredConnectionParameters);

function requestPreferredConnectionParameters(preferredConnectionParameters)

Public Function RequestPreferredConnectionParameters (preferredConnectionParameters As BluetoothLEPreferredConnectionParameters) As BluetoothLEPreferredConnectionParametersRequest

Parameter

preferredConnectionParameters: BluetoothLEPreferredConnectionParameters

Ein BluetoothLEPreferredConnectionParameters-Objekt , das die bevorzugten Bluetooth LE-Verbindungsparameter darstellt.

Gibt zurück

BluetoothLEPreferredConnectionParametersRequest

Ein BluetoothLEPreferredConnectionParametersRequest-Objekt , das die Anforderung der bevorzugten Bluetooth LE-Verbindungsparameter darstellt.

Windows-Anforderungen

Gerätefamilie	Windows 11 (eingeführt in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v14.0)
App-Funktionen	bluetooth

Hinweise

Beim Durchführen von Firmwareupdates ist ein höherer Durchsatz erforderlich, um den Vorgang für den Benutzer schnell abzuschließen. In diesen Szenarien sollten Sie die Verbindungsparameter "ThroughputOptimized" für die Dauer des Firmwareupdates anfordern. Dies reduziert die Anzahl gleichzeitiger Verbindungen mit anderen Bluetooth-Peripheriegeräten und sollte sparsam verwendet werden. Sobald das Firmwareupdate abgeschlossen ist, sollten Sie die Verbindungsparameter auf ihre Standardwerte zurücksetzen, indem Sie entweder das BluetoothLEDevice entfernen oder durch angeforderte neue Verbindungsparameter.

Umgekehrt sollten Sie powerOptimized verwenden, wenn Sie gleichzeitig eine Verbindung mit mehreren LE-Geräten herstellen. Dadurch wird die akzeptable Peripherielatenz für die Verbindung erhöht, wodurch das Intervall verringert wird, in dem das LE-Gerät auf das Hostbetriebssystem reagieren muss. Dies ermöglicht es dem lokalen Bluetooth-Funkgerät, mehr Verbindungen gleichzeitig zu planen, und reduziert den Stromverbrauch sowohl auf dem Hostbetriebssystem als auch auf dem Peripheriegerät.

Gilt für:

Freigeben über