說明

SetClassOfDevice 命令負(fù)責(zé)將本地藍(lán)牙設(shè)備的設(shè)備類別設(shè)置為一個設(shè)備類別值。此函數(shù)在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負(fù)值。必須存在藍(lán)牙協(xié)議棧 ID，才能嘗試調(diào)用此函數(shù)。

參數(shù)

唯一需要的參數(shù)是新的設(shè)備類別值。該值最好是以“0x”開頭，然后使用六位數(shù)值。如果不這樣做，寫入的設(shè)備類別將假定為十進(jìn)制，然后將轉(zhuǎn)換為十六進(jìn)制格式并更改給定的值。

命令調(diào)用示例

• “SetClassOfDevice 0x123456”嘗試將本地藍(lán)牙設(shè)備的設(shè)備類別設(shè)置為“0x123456”。

• “SetClassOfDevice 123456”嘗試將本地藍(lán)牙設(shè)備的設(shè)備類別設(shè)置為“0x01E240”，這相當(dāng)于十進(jìn)制值 123456。

可能的返回值

• (0) 成功設(shè)置本地設(shè)備類別
• (-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 調(diào)用

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 說明

提供此函數(shù)是為了允許更改本地藍(lán)牙設(shè)備的設(shè)備類別。Class_of_Device 參數(shù)表示要寫入本地藍(lán)牙設(shè)備的設(shè)備類別值。如果成功更改設(shè)備類別，此函數(shù)將返回零；如果出現(xiàn)錯誤情況，則返回負(fù)的錯誤代碼。