Year 2023 Changes

Common changes

• New Getting a default audio device for the specified role and data flow has been added to the wclAudioSwitcher class.
• New New error code: WCL_E_AUDIO_SWITCHER_GET_DEFAULT_DEVICE_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_GET_DEVICE_ID_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_DEFAULT_DEVICE_NOT_FOUND.

VCL Edition

• New The new SByte data type has been added.
• Improved The event declarations in the wclBluetoothLeBeaconWatcher class have been changed.
• Fix Fixed the bug with assigning event handlers in design for the wclBluetoothLeBeaconWatcher class if the Bluetooth Framework is used with CBuilder.

Bluetooth Framework

Common changes

• Fix Fixed the bug that caused an application crash during enumerating classic Bluetooth device services.
• Fix Fixed the issue with an incorrect mixed Bluetooth device type detection.

Bluetooth Framework

Common changes

New The Wireless Communication Library VCL edition has been updated to add Embarcadero RAD Studio 12 Athens support.

Common changes

• Fix Fixed the issue when the GATT server did not restart after a client was disconnected.
• Fix Fixed the issue when the GATT server did not restart advertising after a client was disconnected.
• Fix Fixed the issue when reconnecting to the server is rejected after a client was disconnected.
• Fix Fixed the issue with an incorrect event calling order.
• Fix Fixed the issue with the broken data sequence that appeared when data was sent too often using a characteristic value change notification.

C++ Edition

• Fix Fixed the bug when the Bluetooth LE devices can not be discovered.

Bluetooth Framework

Common changes

• Improved The GattClient sample application has been updated to show how to use the new Bluetooth Framework GATT features.
• Improved The EnumPairedDevice method of the wclBluetoothRadio class has been updated to be able to return only Bluetooth LE or only classic Bluetooth devices.
• Changed The error codes that can be returned by the wclAudioSwitcher class have been modified.
• Changed The error codes returned by the wclAudioSwitcher class have been changed.
• Changed The common error codes of the Audio Framework have been changed.
• New The new wclAudioMeter class that allows you to monitor an audio volume level has been added.
• New The new wclAudioVolume class that allows you to control an audio volume has been added.
• New The new AudioVolume sample application has been added.
• New New error code: WCL_E_AUDIO_METER_GET_PEAK_VALUE_FAILED.
• New New error code: WCL_E_AUDIO_METER_CREATE_FAILED.
• New New error code: WCL_E_AUDIO_VOLUME_CREATE_FAILED.
• New New error code: WCL_E_AUDIO_VOLUME_GET_VOLUME_FAILED.
• New New error code: WCL_E_AUDIO_VOLUME_SET_VOLUME_FAILED.
• New New error code: WCL_E_AUDIO_VOLUME_GET_MUTE_FAILED.
• New New error code: WCL_E_AUDIO_VOLUME_SET_MUTE_FAILED.

.NET Edition

• Changed The wclAudioSwitcher class has been moved to the wclAudio namespace.
• Changed The error codes that can be returned by the wclAudioSwitcher class were moved to the new wclAudioErrors class located in the wclAudio namespace.

C++ Edition

• Changed The wclAudioSwitcher class error codes have been moved to the wclAudio namespace in the wclAudioErrors file.
• Changed The wclAudioSwitcher class has been moved to the wclAudio namespace in the wclAudio file.

VCL Edition

• Changed The wclAudioSwitcher class has been moved to the wclAudio file.
• Changed The wclAudioSwitcher class error code declarations have been moved to the wclAudioErrors file.

Bluetooth Framework

Common changes

• Improved The SerialClient sample has been updated to send CR, LF, or CR+LF.

Serial Framework

Common changes

• Improved Compatibility update.

Wi-Fi Framework

Common changes

• Fix Fixed the issue when the incorrect WCL_E_BLUETOOTH_LE_GATT_SERVER_START_FAILED error code was returned when starting a GATT server if Bluetooth hardware did not support peripheral mode.
• New The wclAudioSwitcher class is now able to connect to and to disconnect from a Bluetooth-enabled audio device by the device's MAC address.

Bluetooth Framework

Common changes

• Fix Fixed the bug in the wclGattClient class that caused the disconnection from a device to take too long.
• Improved Minor changes in the wclGattClient class.
• Improved The GattClient sample application has been updated.

Bluetooth Framework

Common changes

• Fix Fixed the bug that caused all Bluetooth LE devices to be detected as mixed with the Microsoft Bluetooth driver.
• Fix Fixed the application crash that appeared when the Close method of the wclBluetoothManager class was called twice.
• Improved The BluetoothManager sample application has been updated to show how to disable pairing handling by the Bluetooth Framework.
• Improved The GattClient sample application has been updated to use the Handle Pairing feature.
• Improved The GattClient sample application has been updated to use the MITM protection pairing feature.
• Improved The GattClient sample application has been updated to use the IO Capabilities pairing feature.

.NET Edition

• Fix Fixed the wclGattClient freezing issue when the wclBluetoothManager class is closing.

Bluetooth Framework

Common changes

• Improved The device type reading code has been updated for the Microsoft Bluetooth driver implementation.
• New New error code: WCL_E_AUDIO_SWITCHER_CLOSED.
• New New error code: WCL_E_AUDIO_SWITCHER_OPENED.
• New New error code: WCL_E_AUDIO_SWITCHER_NOT_OPENED.
• New New error code: WCL_E_AUDIO_SWITCHER_COM_INIT_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_CREATE_ENUMERATOR_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_REGISTER_EVENT_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_ENUM_ENDPOINTS_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_GET_ENDPOIN_COUNT_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_CREATE_CONFIGURATOR_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_SET_DEFAULT_DEVICE_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_FEATURE_NOT_SUPPORTED.
• New New error code: WCL_E_AUDIO_SWITCHER_DEVICE_NOT_FOUND.
• New New error code: WCL_E_AUDIO_SWITCHER_INVALID_DEVICE.
• New New error code: WCL_E_AUDIO_SWITCHER_DEVICE_CONNECTED.
• New New error code: WCL_E_AUDIO_SWITCHER_DEVICE_DISCONNECTED.
• New New error code: WCL_E_AUDIO_SWITCHER_CREATE_TOPOLOGY_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_GET_CONNECTORS_COUNT_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_CONNECT_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_DISCONNECT_FAILED.
• New New error code: WCL_E_AUDIO_SWITCHER_NO_CONNECTORS_FOUND.
• New The new wclAudioSwitcher class.
• New The method to enumerate audio devices has been added.
• New The method to monitor audio device states has been added.
• New The method to change a system default audio device has been added.
• New The method to connect to the already paired Bluetooth audio device has been added.
• New The method to disconnect from the connected Bluetooth audio device has been added.
• New The new AudioSwitcher sample application has been added.

VCL Edition

• Fix Fixed the CBuilder demo applications build issue.

Bluetooth Framework

C++ Edition

• Fix Fixed the IoT sample applications building issue.

VCL Edition

• Fix Fixed the CBuilder sample applications building issue.

Wi-Fi Framework

C++ Edition

• Fix Fixed the IoT sample applications building issue.

VCL Edition

• Fix Fixed the CBuilder sample applications building issue.

Serial Framework

Common changes

• New The new FindService method has been added to the wclGattClient class. The method helps to find a GATT service with a specified UUID.
• New The new FindCharacteristic method has been added to the wclGattClient. The method helps to find a GATT characteristic with a specified UUID.
• Changed Some methods were moved from the wclGattClientConnection class to the wclGattClient class.
• Improved The GattClient sample application has been updated.

Bluetooth Framework

Common changes

• Fix Fixed the bug with setting the Discoverable property to true when Bluetooth LE advertising is running.
• Fix Fixed the issue when power events were not received on some systems.

.NET Edition

• Fix Fixed the bug in the VB.NET GattServer sample application.

Bluetooth Framework

Common changes

• Fix Fixed the issue when power events were not received on some systems.

Wi-Fi Framework

Common changes

• Fix Fixed the issue when power events were not received on some systems.

Serial Framework

Common changes

• New Enumerating installed services for the specified remote device is now possible.

Bluetooth Framework

Common changes

• Improved Compatibility update.

Serial Framework

Common changes

• Improved The data type definitions have been updated for support of the latest authentication and encryption algorithms.
• New New error code: WCL_E_WIFI_RES_NO_VISIBLE_AP.
• New The new OnLinkDegraded event has been added to the wclWiFiEvents class.
• New The new OnLinkImproved event has been added to the wclWiFiEvents class.

Wi-Fi Framework

Common changes

• Fix Minor bug fixes.

.NET Edition

• Fix Fixed the issue when the GetRemoteRssi method always returned 4 instead of the correct RSSI value.

Bluetooth Framework

Common changes

• Fix Minor bug fixes.

Serial Framework

Common changes

• Fix Minor bug fixes.

Wi-Fi Framework

Common changes

• New The new OnConnectionPhyChanged event has been added to the wclGattClient class.
• New Reading a connection PHY is now available in the GATT server.
• New Reading the connection parameters is now available in the GATT server.
• New Changing connection parameters handling is not available in the GATT server.
• New Changing connection PHY handling is not available in the GATT server.
• Improved The GattServer sample application has been updated to show how to read the current connection parameters.
• Improved The GattServer sample application has been updated to show how to read the current connection PHY.
• Changed The WCL_E_BLUETOOTH_LE_GATT_SERVER_RESPONSE_ALREADY_SEND error constant has been changed to WCL_E_BLUETOOTH_LE_GATT_SERVER_RESPONSE_ALREADY_SENT.
• New New error code: WCL_E_BLUETOOTH_LE_CLIENT_NOT_CONNECTED.
• New New error code: WCL_E_BLUETOOTH_LE_SUBSCRIBE_FAILED.
• New New error code: WCL_E_BLUETOOTH_LE_UNSUBSCRIBE_FAILED.

.NET Edition

• Fix Fixed the issue when closing a console application that uses the Bluetooth Framework that caused an application to freeze.
• Fix Fixed the bug when Bluetooth LE devices were not discovered on the Windows 10 IoT Core platform.
• Fix Fixed the bug when not all Bluetooth LE advertisements were captured on the Windows 10 IoT Core platform.

C++ Edition

• Fix Fixed the bug when writing the client configuration descriptor failed on Windows 11.

Bluetooth Framework

Common changes

• New The new wclGattLocalCharacteristicReadRequest class has been added. The class provides information about a GATT server characteristic value read request and allows you to respond to the request with the data or with the error.
• New The new wclGattLocalCharacteristicWriteRequest class has been added. The class provides information about a GATT server characteristic value write request and allows receiving data provided by a GATT client and responding to the request with processing the request result if the Write With Response operation is executing.
• Changed The wclGattLocalCharacteristicValue class has been removed.
• Improved The OnRead event of the wclGattServer class has been changed.
• Improved The OnWrite event of the wclGattServer class has been changed.
• Improved The GattServer sample application has been updated.
• New New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SEND_RESPONSE_FAILED.
• New New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_WRITE_WITHOUT_RESPONSE.
• New New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_RESPONSE_ALREADY_SENT.

Bluetooth Framework

Common changes

• Changed The WCL_E_BLUETOOTH_LE_GET_ADV_PARAMS_FAILED error code has been removed.
• Changed The WCL_E_BLUETOOTH_LE_RESET_ADV_PARAMS_FAILED error code has been removed.
• New New error code: WCL_E_BLUETOOTH_LE_NOTHING_ADVERTISE.
• New New error code: WCL_E_BLUETOOTH_LE_TOO_MANY_ADVERTISEMENTS.
• Improved The number of concurrent advertisements that the wclBluetoothLeAdvertiser class can run at the same time has been limited.
• Changed The OnAdvertisingBegin event has been removed from the wclBluetoothLeAdvertiser class.
• Changed The OnAdvertisingEnd event has been removed from the wclBluetoothLeAdvertiser class.
• Changed The OnAdvertisingError event has been removed from the wclBluetoothLeAdvertiser class.
• Fix Fixed the issue that caused a MAC address change for each advertisement with the Microsoft Bluetooth driver.

Bluetooth Framework

Common changes

• Changed The SetLeScanParams method has been removed from the wclBluetoothRadio class.
• Changed The GetLeScanParams method has been removed from the wclBluetoothRadio class.
• Changed The ResetLeScanParams method has been removed from the wclBluetoothRadio class.
• Changed The SetLeAdvParams method has been removed from the wclBluetoothRadio class.
• Changed The GetLeAdvParams method has been removed from the wclBluetoothRadio class.
• Changed The ResetLeAdvParams method has been removed from the wclBluetoothRadio class.
• New The new ScanInterval and ScanWindow parameters have been added to the Start method of the wclBluetoothLeBeaconWatcher class.
• New The new Interval parameter has been added to the Start method of the wclBluetoothLeAdvertiser class.
• Improved Now changing the Bluetooth LE advertising parameters does not require administrative rights.
• Improved Now changing the Bluetooth LE scan parameters does not require administrative rights.
• Changed The WCL_E_BLUETOOTH_LE_GET_SCAN_PARAMS_FAILED error code has been removed.
• Changed The WCL_E_BLUETOOTH_LE_RESET_SCAN_PARAMS_FAILED error code has been removed.
• New New error code: WCL_E_BLUETOOTH_LE_CREATE_SCAN_PARAMS_SET_EVENT_FAILED.
• New New error code: WCL_E_BLUETOOTH_LE_GET_ADV_PARAMS_FAILED.
• New New error code: WCL_E_BLUETOOTH_RADIO_INSTANCE_NOT_FOUND.
• New New error code: WCL_E_BLUETOOTH_OPEN_RADIO_FAILED.

Bluetooth Framework

Common changes

• New The new LeSupported property has been added to the wclBluetoothRadio class.
• New The new ClassicSupported property has been added to the wclBluetoothRadio class.
• Fix Fixed the issue in the wclBluetoothManager class that appeared if the OnStatusChanged event was called before the AfterOpen event and the Radio object passed to the OnStatusChanged event is not in the radios list.
• Fix Fixed the issue in the wclBluetoothManager class that appeared if the OnStatusChanged event was called after then the BeforeClose event, and the Radio object passed to the OnStatusChanged event can be destroyed before the OnClosed event was called.

Bluetooth Framework

Common changes

• New Now the data processors allow manual data flow management.
• Improved Minor update in the WinAPI declarations.
• New Now it is possible to provide any custom maximum OBEX packet size.

Bluetooth Framework

Common changes

• Improved Minor update in the WinAPI declarations.

Wi-Fi Framework

Common changes

• New Now the data processors allow manual data flow management.
• Fix Fixed the issue with enumerating com0com ports on Windows 10 and above.
• Fix Fixed the issue with com0com ports not being detected on Windows 10 and above.
• Improved Minor update in the WinAPI declarations.
• New Now it is possible to provide any custom maximum OBEX packet size.
• New The new sample applications that show how to use OBEX with a serial connection have been added.

.NET Edition

• Fix Fixed the bug with accessing the Processor property of the wclSerialClient class.

Serial Framework

Common changes

• Changed The WCL_E_WIFI_DIRECT_DEVICE_START_GET_PAIRED_THREAD_FAILED error code has been changed to WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_GET_PAIRED_THREAD_FAILED.
• Changed The WCL_E_WIFI_DIRECT_DEVICE_START_UNPAIR_THREAD_FAILED error code has been changed to WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_UNPAIR_THREAD_FAILED.
• Changed The WCL_E_WIFI_DIRECT_DEVICE_START_NAME_RESOLVING_THREAD_FAILED error code has been changed to WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_NAME_RESOLVING_THREAD_FAILED.
• New New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_ENUM_PAIRED_DEVICES_THREAD_FAILED.
• New New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_ENUMERATE_DEVICES_FAILED.
• New New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_QUERY_ASYNC_INFO_FAILED.
• New New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_GET_ENUM_RESULT_FAILED.
• New Enumerating paired Wi-Fi Direct devices has been added to the wclWiFiDirectDeviceWatcher class.

Wi-Fi Framework

Common changes

• Improved The Bluetooth LE error codes were redefined.
• Improved The RfCommServer sample application has been updated to show how to make the local Bluetooth radio discoverable and connectable.
• Improved The OppServer sample application has been updated to show how to make the local Bluetooth radio discoverable and connectable.
• Fix Minor fixes in the OBEX OPP server implementation.

Bluetooth Framework

Common changes

• Fix Minor fixes in the OBEX OPP server implementation.

Serial Framework

Common changes

• New New GATT errors decoding.
• New New error code: WCL_E_BLUETOOTH_LE_WRITE_WITHOUT_RESPONSE_NOT_SUPPORTED.
• New The new WriteKind parameter has been added to the WriteCharacteristicValue method. The parameter allows you to control a write operation: with or without a response or in auto mode. You can use this parameter instead of changing a characteristic's property.
• New The new SubscribeKind parameter has been added to the WriteClientConfiguration method. The parameter allows you to control how to subscribe to a value change notification. Use this parameter instead of changing a characteristic's property.
• New The new SubscribeKind parameter has been added to the Subscribe method.
• New The new SubscribeKind parameter has been added to the Unsubscribe method.
• New The new SubscribeKind parameter has been added to the SubscribeForNotifications method.
• New The new SubscribeKind parameter has been added to the UnsubscribeFromNotifications method.
• New The new ReadProtectionLevel field has been added to the wclGattLocalDescriptor structure.
• New The new WriteProtectionLevel field has been added to the wclGattLocalDescriptor structure.

Bluetooth Framework