说明

SetClassOfDevice 命令负责将本地蓝牙设备的设备类别设置为一个设备类别值。此函数在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此函数。

参数

唯一需要的参数是新的设备类别值。该值以“0x”开头，后跟一个六位数值。如果不这样做，则写入的设备类别将假定为十进制，并转换为十六进制格式，从而更改给定的值。

命令调用示例

• “SetClassOfDevice 0x123456”尝试将本地蓝牙设备的设备类别设置为“0x123456”。
• “SetClassOfDevice 123456”尝试将本地蓝牙设备的设备类别设置为“0x01E240”，这相当于十进制值 123456。

可能的返回值

• (0) 成功设置本地设备类别
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-8) INVALID_STACK_ID_ERROR
• (-4) FUNCTION_ERROR
• (-5) BTPS_ERROR_GAP_NOT_INITIALIZED

API 调用

GAP_Set_Class_of_Device(BluetoothStackID, Class_of_Device)

API 原型

int BTPSAPI GAP_Set_Class_Of_Device(unsigned int BluetoothStackID, Class_of_Device_t Class_of_Device)

API 说明

提供此函数是为了允许更改本地蓝牙设备的设备类别。Class_of_Device 参数表示要写入本地蓝牙设备的设备类别值。如果成功更改设备类别，此函数将返回零；如果出现错误情况，则返回负的错误代码。