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

UDP 轉送

這個模組包含 UDP 轉送功能的函式。

摘要

啟用 udp-forward 功能 (OPENTHREAD_CONFIG_UDP_FORWARD_ENABLE) 後，即可使用本單元中的函式。

類型
`otUdpForwarder)(otMessage aMessage, uint16_t aPeerPort, otIp6Address aPeerAddr, uint16_t aSockPort, void *aContext)`	typedef `void(*` 此函式指標會將 UDP 封包提供給主機，主機應透過其網路堆疊傳送封包。

函式
`otUdpForwardReceive(otInstance aInstance, otMessage aMessage, uint16_t aPeerPort, const otIp6Address *aPeerAddr, uint16_t aSockPort)`	`void` 處理從主機收到的 UDP 封包。
`otUdpForwardSetForwarder(otInstance aInstance, otUdpForwarder aForwarder, void aContext)`	`void` 設定 UDP 轉送回呼將 UDP 封包傳送至主機。
`otUdpIsPortInUse(otInstance *aInstance, uint16_t port)`	`bool` 判定指定的 UDP 通訊埠是否僅由 OpenThread API 開啟。

類型

OUdpForwarder

void(* otUdpForwarder)(otMessage *aMessage, uint16_t aPeerPort, otIp6Address *aPeerAddr, uint16_t aSockPort, void *aContext)

此函式指標會將 UDP 封包提供給主機，主機應透過其網路堆疊傳送封包。

說明

參數

`[in] aMessage`	指向 UDP 訊息的指標。
`[in] aPeerPort`	目的地 UDP 通訊埠。
`[in] aPeerAddr`	指向目的地 IPv6 位址的指標。
`[in] aSockPort`	來源 UDP 通訊埠。
`[in] aContext`	指向特定應用程式內容的指標。

函式

otUdpForward 接收

void otUdpForwardReceive(
  otInstance *aInstance,
  otMessage *aMessage,
  uint16_t aPeerPort,
  const otIp6Address *aPeerAddr,
  uint16_t aSockPort
)

處理從主機收到的 UDP 封包。

無論通話成功或失敗，訊息都會免費。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aMessage`	指向 UDP 訊息的指標。
`[in] aPeerPort`	來源 UDP 通訊埠。
`[in] aPeerAddr`	指向來源位址的指標。
`[in] aSockPort`	目的地 UDP 通訊埠。

otUdpForwardSetForwarder

void otUdpForwardSetForwarder(
  otInstance *aInstance,
  otUdpForwarder aForwarder,
  void *aContext
)

設定 UDP 轉送回呼將 UDP 封包傳送至主機。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aForwarder`	指向函式呼叫的函式，將 UDP 封包轉送至主機。
`[in] aContext`	指向特定應用程式內容的指標。

otUdpIsPortInUse

bool otUdpIsPortInUse(
  otInstance *aInstance,
  uint16_t port
)

判定指定的 UDP 通訊埠是否僅由 OpenThread API 開啟。

說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] port`	要驗證的 UDP 通訊埠編號。

傳回值

`true`	該連接埠僅供 OpenThread 使用。
`false`	沒有任何 OpenThread API 使用通訊埠，也無法共用通訊埠 (例如 Backbone Socket)。

資源

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