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

連結指標

這個模組包含用來控制連結指標通訊協定的函式。

摘要

列舉
`otLinkMetricsEnhAckFlags{ OT_LINK_METRICS_ENH_ACK_CLEAR = 0, OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }`	enum Enhanced ACK 旗標。
`otLinkMetricsStatus`	enum 連結指標狀態值。

類型
`otLinkMetricsEnhAckFlags`	typedef `enum otLinkMetricsEnhAckFlags` Enhanced ACK 旗標。
`otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress aExtAddress, const otLinkMetricsValues aMetricsValues, void *aContext)`	typedef `void(*` 當系統收到 Enh-ACK Probing IE 時，就會呼叫此函式指標。
`otLinkMetricsMgmtResponseCallback)(const otIp6Address aSource, uint8_t aStatus, void aContext)`	typedef `void(*` 收到連結指標管理回應時，系統就會呼叫此函式指標。
`otLinkMetricsReportCallback)(const otIp6Address aSource, const otLinkMetricsValues aMetricsValues, uint8_t aStatus, void *aContext)`	typedef `void(*` 收到「連結指標」報表時，系統就會呼叫此函式指標。
`otLinkMetricsSeriesFlags`	typedef `struct otLinkMetricsSeriesFlags` 這個結構代表的是下一個轉送序列中包含的頁框。
`otLinkMetricsStatus`	typedef `enum otLinkMetricsStatus` 連結指標狀態值。
`otLinkMetricsValues`	typedef `struct otLinkMetricsValues` 這個結構代表一項連結指標查詢的結果 (值)。

函式
`otLinkMetricsConfigEnhAckProbing(otInstance aInstance, const otIp6Address aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)`	`otError` 這項函式會傳送 MLE 連結指標管理要求，以設定/清除以 Enhanced ACK 為基礎的探測。
`otLinkMetricsConfigForwardTrackingSeries(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext)`	`otError` 這項函式會傳送 MLE 連結指標管理要求，以設定/清除正向追蹤系列。
`otLinkMetricsQuery(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void aCallbackContext)`	`otError` 此函式會傳送 MLE 資料要求以查詢連結指標。
`otLinkMetricsSendLinkProbe(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, uint8_t aLength)`	`otError` 這個函式會傳送 MLE 連結探測訊息。

結構
otLinkMetricsSeriesFlags	這個結構代表的是下一個轉送序列中包含的頁框。
otLinkMetricsValues	這個結構代表一項連結指標查詢的結果 (值)。

列舉

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Enhanced ACK 旗標。

這種憑證是以 Enhanced-ACK 為基礎的探測功能使用，以指出是否要註冊或清除探測。

屬性
`OT_LINK_METRICS_ENH_ACK_CLEAR`	一目了然，
`OT_LINK_METRICS_ENH_ACK_REGISTER`	註冊。

otLinkMetricsStatus

 otLinkMetricsStatus

連結指標狀態值。

類型

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Enhanced ACK 旗標。

這種憑證是以 Enhanced-ACK 為基礎的探測功能使用，以指出是否要註冊或清除探測。

otLinkMetricsEnhAckProbingIeReportCallback

void(* otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)

當系統收到 Enh-ACK Probing IE 時，就會呼叫此函式指標。

說明

參數

`[in] aShortAddress`	探測主題的 Mac 簡短地址。
`[in] aExtAddress`	指向 Probing 主體的 Mac 延伸位址。
`[in] aMetricsValues`	指向 IE 取得的連結指標值的指標。
`[in] aContext`	指向特定應用程式內容的指標。

otLinkMetricsMgmtResponseCallback

void(* otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext)

收到連結指標管理回應時，系統就會呼叫此函式指標。

說明

參數

`[in] aSource`	指向來源位址的指標。
`[in] aStatus`	回應中的狀態碼。
`[in] aContext`	指向特定應用程式內容的指標。

otLinkMetricsReportCallback

void(* otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext)

收到「連結指標」報表時，系統就會呼叫此函式指標。

說明

參數

`[in] aSource`	指向來源位址的指標。
`[in] aMetricsValues`	指向連結指標值 (查詢結果) 的指標。
`[in] aStatus`	報表中的狀態碼 (只有在 `aMetricsValues` 為 NULL 時才能使用)。
`[in] aContext`	指向特定應用程式內容的指標。

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

這個結構代表的是下一個轉送序列中包含的頁框。

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

連結指標狀態值。

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

這個結構代表一項連結指標查詢的結果 (值)。

函式

otLinkMetricsConfigEnhAckProbing

otError otLinkMetricsConfigEnhAckProbing(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  otLinkMetricsEnhAckFlags aEnhAckFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext,
  otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback,
  void *aEnhAckCallbackContext
)

這項函式會傳送 MLE 連結指標管理要求，以設定/清除以 Enhanced ACK 為基礎的探測。

必須啟用 OT_LINK_METRICS_INITIATOR 功能，才能使用這項功能。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDestination`	指向目的地地址的指標。
`[in] aEnhAckFlags`	Enh-ACK 旗標可指出是否要註冊或清除探測。按 `0` 可清除，`1` 則註冊。其他值則保留。
`[in] aLinkMetricsFlags`	指標，用於指定要查詢的指標。應`NULL`時間`aEnhAckFlags`即將`0`的 Google Ads 新帳戶重新申請驗證。
`[in] aCallback`	指向包含連結指標的加強型 Ack 所呼叫的函式。
`[in] aCallbackContext`	指向特定應用程式內容的指標。

傳回值

`OT_ERROR_NONE`	已成功傳送連結指標管理要求訊息。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生 MLE 連結指標管理要求訊息。
`OT_ERROR_INVALID_ARGS`	`aEnhAckFlags` 不是有效的值，或是 `aLinkMetricsFlags` 不正確。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` 不是連結-區域，或是找不到鄰居。
`OT_ERROR_NOT_CAPABLE`	相鄰元素不是 Thread 1.2 裝置，不支援連結指標。

otLinkMetricsConfigForwardTrackingSeries

otError otLinkMetricsConfigForwardTrackingSeries(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  otLinkMetricsSeriesFlags aSeriesFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext
)

這項函式會傳送 MLE 連結指標管理要求，以設定/清除正向追蹤系列。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDestination`	指向目的地地址的指標。
`[in] aSeriesId`	要使用的系列 ID。
`[in] aSeriesFlags`	用於標示應納入考量的影格數訊。
`[in] aLinkMetricsFlags`	指標，用於指定要查詢的指標。應`NULL`時間`aSeriesFlags`即將`0`的 Google Ads 新帳戶重新申請驗證。
`[in] aCallback`	指向收到連結指標管理回應時呼叫的函式。
`[in] aCallbackContext`	指向特定應用程式內容的指標。

傳回值

`OT_ERROR_NONE`	已成功傳送連結指標管理要求訊息。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生 MLE 連結指標管理要求訊息。
`OT_ERROR_INVALID_ARGS`	`aSeriesId` 不在有效範圍內。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` 不是連結-區域，或是找不到鄰居。
`OT_ERROR_NOT_CAPABLE`	相鄰元素不是 Thread 1.2 裝置，不支援連結指標。

otLinkMetrics 查詢

otError otLinkMetricsQuery(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsReportCallback aCallback,
  void *aCallbackContext
)

此函式會傳送 MLE 資料要求以查詢連結指標。

包括單一探測或系列追蹤系列。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDestination`	指向目的地地址的指標。
`[in] aSeriesId`	要查詢的時間序列 ID；0 個單一探測點。
`[in] aLinkMetricsFlags`	指標，用於指定要查詢的指標。
`[in] aCallback`	指向接收連結指標報表所呼叫的函式。
`[in] aCallbackContext`	指向特定應用程式內容的指標。

傳回值

`OT_ERROR_NONE`	已成功傳送連結指標查詢訊息。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生 MLE 資料要求訊息。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` 不是連結-區域，或是找不到鄰居。
`OT_ERROR_NOT_CAPABLE`	相鄰元素不是 Thread 1.2 裝置，不支援連結指標。

otLinkMetricsSendLinkProbe

otError otLinkMetricsSendLinkProbe(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  uint8_t aLength
)

這個函式會傳送 MLE 連結探測訊息。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDestination`	指向目的地地址的指標。
`[in] aSeriesId`	探測訊息所回應的系列 ID [1, 254]。
`[in] aLength`	Link Probe TLV 中的資料酬載長度，0、64。

傳回值

`OT_ERROR_NONE`	已成功傳送連結探測訊息。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生 MLE 連結探測訊息。
`OT_ERROR_INVALID_ARGS`	`aSeriesId` 或 `aLength` 不在有效範圍內。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` 不是連結-區域，或是找不到鄰居。
`OT_ERROR_NOT_CAPABLE`	相鄰元素不是 Thread 1.2 裝置，不支援連結指標。

資源

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