ZHCACZ5 August 2023 CC2564C
GetRemoteName 命令負(fù)責(zé)查詢遠(yuǎn)程設(shè)備的藍(lán)牙設(shè)備名稱。此命令在成功執(zhí)行時(shí)返回零，而在出現(xiàn)任何錯(cuò)誤時(shí)返回負(fù)值。該命令要求在運(yùn)行之前存在有效的藍(lán)牙協(xié)議棧 ID，并在使用 Inquiry 命令后調(diào)用。在這種情況下，DisplayInquiryList 命令可用于查找哪個(gè)遠(yuǎn)程設(shè)備與哪個(gè)查詢索引關(guān)聯(lián)。
GetRemoteName 命令需要一個(gè)參數(shù)，即遠(yuǎn)程藍(lán)牙設(shè)備的查詢索引。該值可以在查詢后找到，或者在使用命令 DisplayInquiryList 時(shí)顯示。命令調(diào)用示例“GetRemoteName 5”嘗試查詢位于第五個(gè)查詢索引處的遠(yuǎn)程設(shè)備的設(shè)備名稱?！癎etRemoteName 8”嘗試查詢位于第八個(gè)查詢索引處的遠(yuǎn)程設(shè)備的設(shè)備名稱。
GAP_Query_Remote_Device_Name(BluetoothStackID, InquiryResultList[(TempParam->Params[0].intParam – 1)], GAP_Event_Callback, (unsigned long)0)
int BTPSAPI GAP_Query_Remote_Device_Name(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Event_Callback_t GAP_Event_Callback, unsigned longCallbackParameter)
提供此函數(shù)是為了能夠查詢指定遠(yuǎn)程藍(lán)牙設(shè)備的用戶友好的藍(lán)牙設(shè)備名稱。該函數(shù)將以下內(nèi)容作為輸入：遠(yuǎn)程藍(lán)牙設(shè)備的地址（用于查詢?cè)撛O(shè)備的名稱）以及 GAP 事件回調(diào)信息（在遠(yuǎn)程設(shè)備名稱查詢過(guò)程完成時(shí)需要使用）。如果成功，此函數(shù)返回零；如果無(wú)法提交遠(yuǎn)程名稱請(qǐng)求，則返回負(fù)的錯(cuò)誤代碼。如果此函數(shù)返回成功，則在已確定遠(yuǎn)程名稱信息（或如果存在錯(cuò)誤）時(shí)，將通過(guò)指定的回調(diào)通知調(diào)用方。此函數(shù)無(wú)法用于確定本地藍(lán)牙設(shè)備的用戶友好名稱。GAP_Query_Local_Name 函數(shù)用于查詢本地藍(lán)牙設(shè)備的用戶友好名稱。由于此函數(shù)本質(zhì)上是異步的（指定遠(yuǎn)程設(shè)備地址），因此該函數(shù)通過(guò)指定的回調(diào)向調(diào)用方通知結(jié)果。通過(guò)發(fā)出 GAP_Cancel_Query_Remote_Name 函數(shù)并指定藍(lán)牙設(shè)備的藍(lán)牙設(shè)備地址（在對(duì)該函數(shù)的原始調(diào)用中指定），調(diào)用方可以隨時(shí)取消遠(yuǎn)程名稱請(qǐng)求。取消回調(diào)時(shí)，仍會(huì)嘗試執(zhí)行此操作，然后取消回調(diào)（即 GAP 模塊仍可以執(zhí)行遠(yuǎn)程名稱請(qǐng)求，但從不發(fā)出回調(diào)）。