BluetoothLEDevice.RequestPreferredConnectionParameters Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 BluetoothLEPreferredConnectionParametersRequestParameters
- preferredConnectionParameters
- BluetoothLEPreferredConnectionParameters
A BluetoothLEPreferredConnectionParameters object representing the Bluetooth LE preferred connection parameters.
Returns
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.