BluetoothDevice Class
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.
Represents a Bluetooth device.
Sample applications that use this class include Device enumeration and pairing sample and Bluetooth RFCOMM chat sample.
public ref class BluetoothDevice sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BluetoothDevice final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BluetoothDevice : System.IDisposable
Public NotInheritable Class BluetoothDevice
Implements IDisposable
- Inheritance
- Attributes
- Implements
Windows requirements
Device family |
Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
App capabilities |
bluetooth
|
Remarks
Version history
Windows version | SDK version | Value added |
---|---|---|
1511 | 10586 | DeviceInformation |
1511 | 10586 | GetDeviceSelectorFromBluetoothAddress |
1511 | 10586 | GetDeviceSelectorFromClassOfDevice |
1511 | 10586 | GetDeviceSelectorFromConnectionStatus |
1511 | 10586 | GetDeviceSelectorFromDeviceName |
1511 | 10586 | GetDeviceSelectorFromPairingState |
1607 | 14393 | DeviceAccessInformation |
1607 | 14393 | GetRfcommServicesAsync |
1607 | 14393 | GetRfcommServicesAsync(BluetoothCacheMode) |
1607 | 14393 | GetRfcommServicesForIdAsync(RfcommServiceId) |
1607 | 14393 | GetRfcommServicesForIdAsync(RfcommServiceId,BluetoothCacheMode) |
1607 | 14393 | RequestAccessAsync |
1709 | 16299 | BluetoothDeviceId |
1803 | 17134 | WasSecureConnectionUsedForPairing |
Properties
BluetoothAddress |
Gets the device address. |
BluetoothDeviceId |
Gets the bluetooth device ID. |
ClassOfDevice |
Gets the Bluetooth Class Of Device information of the device. |
ConnectionStatus |
Gets the connection status of the device. |
DeviceAccessInformation |
The current DeviceAccessInformation object for the device. Used to check and monitor access changes to the device. |
DeviceId |
Gets the device ID that came from the Windows.Devices.Enumeration.DeviceInformation.Id |
DeviceInformation |
Gets the DeviceInformation object for the Bluetooth device. |
HostName |
Gets the HostName of the device. |
Name |
Gets the Name of the device. |
RfcommServices |
Gets the read-only list of RFCOMM services supported by the device. Important The RfcommServices API is deprecated, and it may not be available in future versions of Windows. Instead, use GetRfcommServicesAsync. |
SdpRecords |
Gets the read-only list of Service Discovery Protocol (SDP) records for the device. |
WasSecureConnectionUsedForPairing |
Gets a boolean indicating whether the BluetoothDevice was paired using a Secure Connection. |
Methods
Close() |
Closes the Bluetooth device. |
Dispose() |
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. |
FromBluetoothAddressAsync(UInt64) |
Returns a BluetoothDevice object for the given BluetoothAddress. |
FromHostNameAsync(HostName) |
Returns a BluetoothDevice object identified by the given HostName. |
FromIdAsync(String) |
Returns a BluetoothDevice object identified by the given DeviceId. |
GetDeviceSelector() |
Gets an Advanced Query Syntax (AQS) string for identifying instances of this device. This string is passed to the FindAllAsync or CreateWatcher method. |
GetDeviceSelectorFromBluetoothAddress(UInt64) |
Creates an Advanced Query Syntax (AQS) filter string from a 64-bit address that represents a Bluetooth device. The AQS string is passed into the CreateWatcher method to return a collection of DeviceInformation objects. |
GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice) |
Creates an Advanced Query Syntax (AQS) filter string from a BluetoothClassOfDevice object. The AQS string is passed into the CreateWatcher method to return a collection of DeviceInformation objects. |
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus) |
Creates an Advanced Query Syntax (AQS) filter string that contains a query for Bluetooth devices with the indicated BluetoothConnectionStatus. The AQS string is passed into the CreateWatcher method to return a collection of DeviceInformation objects with the indicated Bluetooth connection status. |
GetDeviceSelectorFromDeviceName(String) |
Creates an Advanced Query Syntax (AQS) filter string that contains a query for the Bluetooth device name. The AQS string is passed into the CreateWatcher method to return a collection of DeviceInformation objects containing the specified Bluetooth device name. |
GetDeviceSelectorFromPairingState(Boolean) |
Creates an Advanced Query Syntax (AQS) filter string that contains a query for Bluetooth devices that are either paired or unpaired. The AQS string is passed into the CreateWatcher method to return a collection of DeviceInformation objects. |
GetRfcommServicesAsync() |
Retrieves all Rfcomm Services on the remote Bluetooth Device. |
GetRfcommServicesAsync(BluetoothCacheMode) |
Retrieves all cached Rfcomm Services on the remote Bluetooth Device. |
GetRfcommServicesForIdAsync(RfcommServiceId) |
Retrieves all Rfcomm Services on the Remote Bluetooth Device matching the specified RfcommServiceId. |
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode) |
Retrieves all cached Rfcomm Services on the Remote Bluetooth Device matching the specified RfcommServiceId. |
RequestAccessAsync() |
Used to request explicit access to the Bluetooth device. This invokes Device Consent and must be called on the UI thread. |
Events
ConnectionStatusChanged |
Occurs when the connection status of the device has changed. |
NameChanged |
Occurs when the name of the device has changed. |
SdpRecordsChanged |
Occurs when the list SDP records for the device has changed. |
Applies to
See also
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för