說明

SetDiscoverabilityMode 命令負(fù)責(zé)設(shè)置本地設(shè)備的可發(fā)現(xiàn)性模式。此命令在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負(fù)值。必須存在藍(lán)牙協(xié)議棧 ID，才能嘗試調(diào)用此函數(shù)。如果將設(shè)備設(shè)置為“有限可發(fā)現(xiàn)”，則該設(shè)備的可發(fā)現(xiàn)時間為 60 秒；而“一般可發(fā)現(xiàn)”設(shè)備始終是可發(fā)現(xiàn)的。

參數(shù)

此命令只需要一個表示可發(fā)現(xiàn)性模式的整數(shù)值參數(shù)。該值必須指定為 0（表示不可發(fā)現(xiàn)模式）、1（表示有限可發(fā)現(xiàn)模式）或 2（表示一般可發(fā)現(xiàn)模式）。

命令調(diào)用示例

• “SetDiscoverabilityMode 0”嘗試將本地設(shè)備的可發(fā)現(xiàn)性模式更改為不可發(fā)現(xiàn)。
• “SetDiscoverabilityMode 1”嘗試將本地設(shè)備的可發(fā)現(xiàn)性模式更改為有限可發(fā)現(xiàn)。
• “SetDiscoverabilityMode 2”嘗試將本地設(shè)備的可發(fā)現(xiàn)性模式更改為一般可發(fā)現(xiàn)。

可能的返回值

• (0) 成功設(shè)置可發(fā)現(xiàn)性模式
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-5) BTPS_ERROR_GAP_NOT_INITIALIZED
• (-58) BTPS_ERROR_INVALID_MODE
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR
• (-64) BTPS_ERROR_INTERNAL_ERROR
• (-1) BTPS_ERROR_INVALID_PARAMETER

API 調(diào)用

GAP_Set_Discoverability_Mode(BluetoothStackID, DiscoverabilityMode, (DiscoverabilityMode == dmLimitedDiscoverableMode)?60:0)

API 原型

int BTPSAPI GAP_Set_Discoverability_Mode(unsigned int BluetoothStackID, GAP_Discoverability_Mode_t GAP_Discoverability_Mode, unsigned int Max_Discoverable_Time)

API 說明

提供此函數(shù)是為了設(shè)置由藍(lán)牙協(xié)議棧 ID 指定的藍(lán)牙協(xié)議棧所指定的本地藍(lán)牙設(shè)備的可發(fā)現(xiàn)性模式。第二個參數(shù)指定要將本地藍(lán)牙設(shè)備置于的可發(fā)現(xiàn)性模式，第三個參數(shù)指定要將本地藍(lán)牙設(shè)備置于指定的可發(fā)現(xiàn)模式的時間長度（以秒為單位）（如果未指定為不可發(fā)現(xiàn)模式）。在這段時間結(jié)束時（假設(shè)時間不是無限的），本地藍(lán)牙設(shè)備將返回到不可發(fā)現(xiàn)模式。