BluetoothLEDevice.RequestPreferredConnectionParameters Method

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

Returns

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

Windows requirements

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