說明

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 參數表示要寫入本地藍牙設備的設備類別值。如果成功更改設備類別，此函數將返回零；如果出現錯誤情況，則返回負的錯誤代碼。