BluetoothLEDevice.RequestPreferredConnectionParameters Method

Definition

Retrieves a Bluetooth LE preferred connection parameters request object for the specified Bluetooth LE preferred connection parameters object.

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

Parameters

preferredConnectionParameters
BluetoothLEPreferredConnectionParameters

A BluetoothLEPreferredConnectionParameters object representing the Bluetooth LE preferred connection parameters.

Returns

BluetoothLEPreferredConnectionParametersRequest

A BluetoothLEPreferredConnectionParametersRequest object representing the Bluetooth LE preferred connection parameters request.

Windows requirements

Device family
Windows 11 (introduced in 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v14.0)
App capabilities
bluetooth

Remarks

When performing firmware updates, higher throughput is necessary to complete the operation swiftly for the user. In those scenarios, you should request ThroughputOptimized connection parameters for the duration of the firmware update. That will reduce the number of concurrent connections to other Bluetooth peripherals, and should be used sparingly. Once the firmware update is completed, you should restore the connection parameters to their defaults, either by disposing of the BluetoothLEDevice, or by requested new connection parameters.

Conversely, when connecting to multiple LE devices concurrently, you should use PowerOptimized. That will increase the acceptable peripheral latency for the connection, reducing the interval at which the LE device must respond to the host OS. That allows the local Bluetooth radio to schedule more connections concurrently, and reduces power usage on both the host OS and on the peripheral device.

Applies to