DNS - プラットフォーム

このモジュールには、アップストリームの DNS サーバーに再帰 DNS クエリを送信するためのプラットフォーム抽象化が含まれています。

概要

Typedef
`otPlatDnsUpstreamQuery`	typedef `struct otPlatDnsUpstreamQuery` この不透明タイプは、アップストリームの DNS クエリトランザクションを表します。

関数
`otPlatDnsCancelUpstreamQuery(otInstance aInstance, otPlatDnsUpstreamQuery aTxn)`	`void` アップストリームクエリのトランザクションをキャンセルします。
`otPlatDnsStartUpstreamQuery(otInstance aInstance, otPlatDnsUpstreamQuery aTxn, const otMessage *aQuery)`	`void` アップストリームクエリトランザクションを開始します。
`otPlatDnsUpstreamQueryDone(otInstance aInstance, otPlatDnsUpstreamQuery aTxn, otMessage *aResponse)`	`void` プラットフォームはこの関数を呼び出して DNS クエリを終了します。

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

この不透明タイプは、アップストリームの DNS クエリトランザクションを表します。

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

アップストリームクエリのトランザクションをキャンセルします。

プラットフォームは、otPlatDnsUpstreamQueryDone を呼び出してリソースを解放する必要があります。

詳細

パラメータ

`[in] aInstance`	OpenThread インスタンスの構造。
`[in] aTxn`	不透明な DNS クエリトランザクションオブジェクトへのポインタ。

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

アップストリームクエリトランザクションを開始します。

成功の場合（および DNS プロトコルメッセージで表されるエラー）、プラットフォームは otPlatDnsUpstreamQueryDone を呼び出すことが想定されます。
OpenThread コアは、otPlatDnsCancelUpstreamQuery を呼び出すことでクエリトランザクションをキャンセルできます（タイムアウトになる可能性もあります）。プラットフォームは、キャンセルされたトランザクションで otPlatDnsUpstreamQueryDone を呼び出してはいけません。

詳細

パラメータ

`[in] aInstance`	OpenThread インスタンスの構造。
`[in] aTxn`	不透明な DNS クエリトランザクションオブジェクトへのポインタ。
`[in] aQuery`	アップストリームの DNS サーバーに送信する DNS ペイロードのメッセージバッファ。

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

プラットフォームはこの関数を呼び出して DNS クエリを終了します。

トランザクションは解放されるため、プラットフォームは同じトランザクションを 2 回呼び出すことはできません。この関数は、aResponse の所有権を OpenThread スタックに渡します。

プラットフォームは nullptr を渡して、レスポンスなしでトランザクションを完了できます。

詳細

パラメータ

`[in] aInstance`	OpenThread インスタンスの構造。
`[in] aTxn`	不透明な DNS クエリトランザクションオブジェクトへのポインタ。
`[in] aResponse`	DNS レスポンスペイロードのメッセージバッファ、またはレスポンスなしでトランザクションを閉じる `nullptr`。