本頁面由 Cloud Translation API 翻譯而成。

重要通知寄件者

這個檔案含有連線偵測 (ping) 傳送者模組的 OpenThread API。

摘要

類型
`otPingSenderConfig`	typedef `struct otPingSenderConfig` 這個結構代表了連線偵測要求設定。
`otPingSenderReply`	typedef `struct otPingSenderReply` 這個結構代表了連線偵測 (ping) 的回覆。
`otPingSenderReplyCallback)(const otPingSenderReply aReply, void aContext)`	typedef `void(*` 此函式指標類型會指定接收連線偵測 (ping) 回覆的回呼。
`otPingSenderStatistics`	typedef `struct otPingSenderStatistics` 這個結構代表連線偵測 (ping) 要求的統計資料。
`otPingSenderStatisticsCallback)(const otPingSenderStatistics aStatistics, void aContext)`	typedef `void(*` 此函式指標類型可指定用來回報連線偵測 (ping) 統計資料的回呼。

函式
`otPingSenderPing(otInstance aInstance, const otPingSenderConfig aConfig)`	`otError` 這個函式會啟動連線偵測 (ping)。
`otPingSenderStop(otInstance *aInstance)`	`void` 這項函式會停止進行中的連線偵測 (ping)。

struct otPingSenderConfig otPingSenderConfig

這個結構代表了連線偵測要求設定。

struct otPingSenderReply otPingSenderReply

這個結構代表了連線偵測 (ping) 的回覆。

void(* otPingSenderReplyCallback)(const otPingSenderReply *aReply, void *aContext)

此函式指標類型會指定接收連線偵測 (ping) 回覆的回呼。

說明

參數

`[in] aReply`	指向 `otPingSenderReply` 的遊標，其中包含收到的連線偵測 (ping) 回覆的相關資訊。
`[in] aContext`	指向特定應用程式內容的指標。

struct otPingSenderStatistics otPingSenderStatistics

這個結構代表連線偵測 (ping) 要求的統計資料。

void(* otPingSenderStatisticsCallback)(const otPingSenderStatistics *aStatistics, void *aContext)

此函式指標類型可指定用來回報連線偵測 (ping) 統計資料的回呼。

說明

參數

`[in] aStatistics`	指向 `otPingSenderStatistics` 的遊標，其中包含接收的連線偵測 (ping) 統計資料的相關資訊。
`[in] aContext`	指向特定應用程式內容的指標。

otError otPingSenderPing(
  otInstance *aInstance,
  const otPingSenderConfig *aConfig
)

這個函式會啟動連線偵測 (ping)。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aConfig`	要使用的連線偵測 (ping) 設定。

傳回值

`OT_ERROR_NONE`	已成功啟動連線偵測 (ping)。
`OT_ERROR_BUSY`	無法依先前的連線偵測 (ping) 要求執行，因此無法啟動。
`OT_ERROR_INVALID_ARGS`	`aConfig` 包含無效參數 (例如連線偵測 (ping) 間隔過長)。

void otPingSenderStop(
  otInstance *aInstance
)

這項函式會停止進行中的連線偵測 (ping)。

說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

OpenThread API 參照主題來自原始碼，位於 GitHub。如需更多資訊或參閱我們的說明文件，請參閱資源。