Serwer DNS-SD

Ten moduł zawiera interfejsy API dla serwera DNS-SD.

Podsumowanie

Wyliczenia

otDnssdQueryType{
  OT_DNSSD_QUERY_TYPE_NONE = 0,
  OT_DNSSD_QUERY_TYPE_BROWSE = 1,
  OT_DNSSD_QUERY_TYPE_RESOLVE = 2,
  OT_DNSSD_QUERY_TYPE_RESOLVE_HOST = 3
}
enum | typ wyliczeniowy
To wyliczenie określa typ zapytania DNS-SD.

Typy

otDnssdCounters typedef
Ta struktura zawiera liczniki serwera DNS-SD.
otDnssdHostInfo typedef
Taka struktura reprezentuje informacje o wykrytym hoście w zapytaniu DNS-SD.
otDnssdQuery typedef
void
Ten nieprzezroczystość reprezentuje zapytanie DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Ta funkcja jest wywoływana, gdy zapytanie DNS-SD subskrybuje jeden z:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Ta funkcja jest wywoływana, gdy zapytanie DNS-SD anuluje jedno z tych działań:
otDnssdServiceInstanceInfo typedef
Ta struktura przedstawia informacje o wykrytej instancji usługi dla zapytania DNS-SD.

Funkcje

otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Ta funkcja zwraca liczniki serwera DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Ta funkcja pobiera następne zapytanie z serwera DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Ta funkcja pozyskuje typ i nazwę zapytania DNS-SD dla konkretnego zapytania.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Ta funkcja powiadamia wykrytego hosta.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Ta funkcja powiadamia o wykrytej instancji usługi.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Ta funkcja ustawia wywołania zwrotne serwera DNS-SD.

Struktury

Liczniki zdarzeń OTDnssd

Ta struktura zawiera liczniki serwera DNS-SD.

otDnssdHostInfo

Taka struktura reprezentuje informacje o wykrytym hoście w zapytaniu DNS-SD.

otDnssdServiceInstanceInfo

Ta struktura przedstawia informacje o wykrytej instancji usługi dla zapytania DNS-SD.

Wyliczenia

Typ zapytania otDnssd

 otDnssdQueryType

To wyliczenie określa typ zapytania DNS-SD.

Właściwości
OT_DNSSD_QUERY_TYPE_BROWSE

Usługa przeglądania typu usługi.

OT_DNSSD_QUERY_TYPE_NONE

Nieokreślony typ usługi.

OT_DNSSD_QUERY_TYPE_RESOLVE

Typ usługi rozpoznawania instancji usługi.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Typ usługi rozpoznaj nazwę hosta.

Typy

Liczniki OTDnssdd

struct otDnssdCounters otDnssdCounters

Ta struktura zawiera liczniki serwera DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Taka struktura reprezentuje informacje o wykrytym hoście w zapytaniu DNS-SD.

otDnssdQuery

void otDnssdQuery

Ten nieprzezroczystość reprezentuje zapytanie DNS-SD.

otDnssdQuerySubskrybuj wywołanie zwrotne

void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)

Ta funkcja jest wywoływana, gdy zapytanie DNS-SD subskrybuje jeden z:

  1. nazwę usługi.
  2. nazwę instancji usługi.
  3. nazwa hosta.

Wdrożenie zapytania DNS-SD odpowiada za określenie, co to jest aFullName. Jeśli aFullName to nazwa usługi lub nazwa instancji usługi, implementacja zapytania DNS-SD powinna wykryć odpowiednie informacje o instancji usługi i powiadomić serwer DNS-SD za pomocą otDnssdQueryHandleDiscoveredServiceInstance. Jeśli aFullName to nazwa hosta, implementacja zapytania DNS-SD powinna wykryć informacje o hoście i powiadomić serwer DNS-SD za pomocą otDnssdQueryHandleDiscoveredHost.

Szczegóły
Parametry
[in] aContext
Wskaźnik określający kontekst aplikacji.
[in] aFullName
Pełna nazwa usługi unieważniona (np. "_ipps._tcp.default.service.arpa.") lub pełna nazwa instancji usługi (np. "OpenThread._ipps._tcp.default.service.arpa.") lub pełna nazwa hosta (np. &quot.ott.service.default.default.default.default.
Przeczytaj też:
otDnssdQueryHandleDiscoveredService
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallBackback

void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)

Ta funkcja jest wywoływana, gdy zapytanie DNS-SD anuluje jedno z tych działań:

  1. nazwę usługi.
  2. nazwę instancji usługi.
  3. nazwa hosta.

Wdrożenie zapytania DNS-SD odpowiada za określenie, co to jest aFullName.

Szczegóły
Parametry
[in] aContext
Wskaźnik określający kontekst aplikacji.
[in] aFullName
Pełna nazwa usługi zakończona na null (np. "_ipps._tcp.default.service.arpa.") lub pełna nazwa instancji usługi (np. "OpenThread._ipps._tcp.default.service.arpa.").

Informacje o instancji otDnssdService

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Ta struktura przedstawia informacje o wykrytej instancji usługi dla zapytania DNS-SD.

Funkcje

Liczniki w otDnssdGet

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Ta funkcja zwraca liczniki serwera DNS-SD.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
Zwroty
Wskaźnik liczników serwera DNS-SD.

OTDnssdGetNextQuery

const otDnssdQuery * otDnssdGetNextQuery(
  otInstance *aInstance,
  const otDnssdQuery *aQuery
)

Ta funkcja pobiera następne zapytanie z serwera DNS-SD.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aQuery
Wskaźnik zapytania. Przekaż wartość NULL, aby otrzymać pierwsze zapytanie.
Zwroty
Wskaźnik lub NULL, jeśli nie ma więcej zapytań.

otDnssdGetQueryTypeAndName

otDnssdQueryType otDnssdGetQueryTypeAndName(
  const otDnssdQuery *aQuery,
  char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]
)

Ta funkcja pozyskuje typ i nazwę zapytania DNS-SD dla konkretnego zapytania.

Szczegóły
Parametry
[in] aQuery
Wskaźnik zapytania uzyskany od: otDnssdGetNextQuery.
[out] aNameOutput
Bufor wyjściowy danych, który powinien mieć OT_DNS_MAX_NAME_SIZE B.
Zwroty
Typ zapytania DNS-SD.

otDnssdQueryHandleDiscoveredHost

void otDnssdQueryHandleDiscoveredHost(
  otInstance *aInstance,
  const char *aHostFullName,
  otDnssdHostInfo *aHostInfo
)

Ta funkcja powiadamia wykrytego hosta.

Zewnętrzny resolver zapytań (np. Discovery Proxy) powinien wywołać tę funkcję, by powiadomić węzeł główny OpenThread o subskrybowanych hostach.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aHostFullName
Pełna nazwa hosta o wartości null.
[in] aHostInfo
Wskaźnik wskazujący wykrytą instancję usługi.

otDnssdQueryHandleDiscoveredServiceInstance

void otDnssdQueryHandleDiscoveredServiceInstance(
  otInstance *aInstance,
  const char *aServiceFullName,
  otDnssdServiceInstanceInfo *aInstanceInfo
)

Ta funkcja powiadamia o wykrytej instancji usługi.

Zewnętrzny resolver zapytań (np. Discovery Proxy) powinien wywołać tę funkcję, by powiadamiać główny element OpenThread o subskrybowanych usługach lub instancjach usług.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aServiceFullName
Pełna nazwa usługi unieważniona o wartości null.
[in] aInstanceInfo
Wskaźnik wskazujący wykrytą instancję usługi.

Wywołania zwrotne zapytania otDnssdQuerySet

void otDnssdQuerySetCallbacks(
  otInstance *aInstance,
  otDnssdQuerySubscribeCallback aSubscribe,
  otDnssdQueryUnsubscribeCallback aUnsubscribe,
  void *aContext
)

Ta funkcja ustawia wywołania zwrotne serwera DNS-SD.

Serwer DNS-SD wywołuje stronę aSubscribe, aby zasubskrybować usługę lub instancję usługi i uzyskać dostęp do zapytania DNS-SD, a aUnsubscribe do anulowania subskrypcji po rozwiązaniu zapytania lub przekroczeniu limitu czasu.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aSubscribe
Wskaźnik do funkcji wywołania zwrotnego, który pozwala zasubskrybować usługę lub instancję usługi.
[in] aUnsubscribe
Wskaźnik do funkcji wywołania zwrotnego, który pozwala anulować subskrypcję usługi lub instancji usługi.
[in] aContext
Wskaźnik określający kontekst aplikacji.

Zasoby

Tematy referencyjne interfejsu API OpenThread pochodzą z kodu źródłowego i są dostępne w GitHub. Więcej informacji oraz dodatkowe informacje znajdziesz w materiałach.