ZHCACY9 August 2023 CC2564C
GetRemoteName 命令負責查詢遠程設備的藍牙設備名稱。此函數(shù)在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負值。該命令要求在運行之前存在有效的藍牙協(xié)議棧 ID，并在使用 Inquiry 命令后調(diào)用。在這種情況下，DisplayInquiryList 命令可用于查找哪個遠程設備與哪個查詢索引關聯(lián)。
GetRemoteName 命令需要一個參數(shù)，即遠程藍牙設備的查詢索引。該值可以在查詢后找到，或者在使用命令 DisplayInquiryList 時顯示。
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ù)是為了能夠查詢指定遠程藍牙設備的用戶友好的藍牙設備名稱。該函數(shù)將以下內(nèi)容作為輸入：遠程藍牙設備的地址（用于查詢該設備的名稱）以及 GAP 事件回調(diào)信息（在遠程設備名稱查詢過程完成時需要使用）。如果成功，此函數(shù)返回零；如果無法提交遠程名稱請求，則返回負的錯誤代碼。如果此函數(shù)返回成功結(jié)果，則在確定遠程名稱信息后（或存在錯誤時），將通過指定的回調(diào)通知調(diào)用方。此函數(shù)無法用于確定本地藍牙設備的用戶友好名稱。GAP_Query_Local_Name 函數(shù)不得用于查詢本地藍牙設備的用戶友好名稱。由于此函數(shù)本質(zhì)上是異步的（指定遠程設備地址），因此該函數(shù)通過指定的回調(diào)向調(diào)用方通知結(jié)果。通過發(fā)出 GAP_Cancel_Query_Remote_Name 函數(shù)并指定藍牙設備的藍牙設備地址（在對該函數(shù)的原始調(diào)用中指定），調(diào)用方可以隨時取消遠程名稱請求。請注意，取消回調(diào)后，該操作會發(fā)出取消嘗試，然后回調(diào)會被取消（即，GAP 模塊仍可執(zhí)行遠程名稱請求，但從未發(fā)出回調(diào)）。