說明

GetRemoteName 命令負(fù)責(zé)查詢遠(yuǎn)程設(shè)備的藍(lán)牙設(shè)備名稱。此函數(shù)在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負(fù)值。此命令要求在運(yùn)行之前存在有效的藍(lán)牙協(xié)議棧 ID，并在使用 Inquiry 命令后調(diào)用。在這種情況下，DisplayInquiryList 命令可用于查找哪個遠(yuǎn)程設(shè)備與哪個查詢索引關(guān)聯(lián)。

參數(shù)

GetRemoteName 命令需要一個參數(shù)，即遠(yuǎn)程藍(lán)牙設(shè)備的查詢索引。該值可以在查詢后找到，或者在使用命令 DisplayInquiryList 時顯示。

命令調(diào)用示例

• “GetRemoteName 5”嘗試查詢位于第五個查詢索引處的遠(yuǎn)程設(shè)備的設(shè)備名稱。
• “GetRemoteName 8”嘗試查詢位于第八個查詢索引處的遠(yuǎn)程設(shè)備的設(shè)備名稱。

可能的返回值

• (0) 成功查詢遠(yuǎn)程名稱
• (-6) INVALID_PARAMETERS_ERROR
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-59) BTPS_ERROR_ADDING_CALLBACK_INFORMATION
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 調(diào)用

GAP_Query_Remote_Device_Name(BluetoothStackID, InquiryResultList[(TempParam->Params[0].intParam – 1)], GAP_Event_Callback, (unsigned long)0);

API 原型

int BTPSAPI GAP_Query_Remote_Device_Name(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Event_Callback_t GAP_Event_Callback, unsigned longCallbackParameter);

API 說明

提供此函數(shù)是為了能夠查詢指定遠(yuǎn)程藍(lán)牙設(shè)備的用戶友好的藍(lán)牙設(shè)備名稱。該函數(shù)將以下內(nèi)容作為輸入：遠(yuǎn)程藍(lán)牙設(shè)備的地址（用于查詢該設(shè)備的名稱）以及 GAP 事件回調(diào)信息（在遠(yuǎn)程設(shè)備名稱查詢過程完成時需要使用）。如果成功，此函數(shù)返回零；如果無法提交遠(yuǎn)程名稱請求，則返回負(fù)的錯誤代碼。如果此函數(shù)返回成功結(jié)果，則在確定遠(yuǎn)程名稱信息后（或存在錯誤時），將通過指定的回調(diào)通知調(diào)用方。此函數(shù)無法用于確定本地藍(lán)牙設(shè)備的用戶友好名稱。GAP_Query_Local_Name 函數(shù)用于查詢本地藍(lán)牙設(shè)備的用戶友好名稱。由于此函數(shù)本質(zhì)上是異步的（指定遠(yuǎn)程設(shè)備地址），因此該函數(shù)通過指定的回調(diào)向調(diào)用方通知結(jié)果。通過發(fā)出 GAP_Cancel_Query_Remote_Name 函數(shù)并指定藍(lán)牙設(shè)備的藍(lán)牙設(shè)備地址（在對該函數(shù)的原始調(diào)用中指定），調(diào)用方可以隨時取消遠(yuǎn)程名稱請求。請注意，如果取消回調(diào)并且操作嘗試取消，則會取消回調(diào)（即，GAP 模塊仍執(zhí)行遠(yuǎn)程名稱請求，但始終不發(fā)出回調(diào)）。