Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Server DNS-SD

Modul ini mencakup API untuk server DNS-SD.

Ringkasan

Pencacahan

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
Pencacahan ini menentukan jenis kueri DNS-SD.

Typedefs

otDnssdHostInfo typedef
Struktur ini mewakili informasi dari host yang ditemukan untuk kueri DNS-SD.
otDnssdQuery typedef
void
Jenis buram ini mewakili kueri DNS-SD.
otDnssdQuerySubscribeCallback )(void *aContext, const char *aFullName) typedef
void(*
Fungsi ini dipanggil ketika kueri DNS-SD berlangganan salah satu dari:
otDnssdQueryUnsubscribeCallback )(void *aContext, const char *aFullName) typedef
void(*
Fungsi ini dipanggil saat kueri DNS-SD berhenti berlangganan salah satu dari:
otDnssdServiceInstanceInfo typedef
Struktur ini mewakili informasi dari contoh layanan yang ditemukan untuk kueri DNS-SD.

Fungsi

otDnssdGetNextQuery ( otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Fungsi ini mendapatkan kueri berikutnya di server DNS-SD.
otDnssdGetQueryTypeAndName (const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Fungsi ini memperoleh jenis dan nama kueri DNS-SD untuk kueri tertentu.
otDnssdQueryHandleDiscoveredHost ( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Fungsi ini memberi tahu host yang ditemukan.
otDnssdQueryHandleDiscoveredServiceInstance ( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Fungsi ini memberi tahu contoh layanan yang ditemukan.
otDnssdQuerySetCallbacks ( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Fungsi ini menyetel panggilan balik kueri server DNS-SD.

Structs

otDnssdHostInfo

Struktur ini mewakili informasi dari host yang ditemukan untuk kueri DNS-SD.

otDnssdServiceInstanceInfo

Struktur ini mewakili informasi dari contoh layanan yang ditemukan untuk kueri DNS-SD.

Pencacahan

otDnssdQueryType

 otDnssdQueryType

Pencacahan ini menentukan jenis kueri DNS-SD.

Properti
OT_DNSSD_QUERY_TYPE_BROWSE

Jenis layanan layanan jelajah.

OT_DNSSD_QUERY_TYPE_NONE

Jenis layanan tidak ditentukan.

OT_DNSSD_QUERY_TYPE_RESOLVE

Jenis layanan menyelesaikan contoh layanan.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Jenis layanan menyelesaikan nama host.

Typedefs

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Struktur ini mewakili informasi dari host yang ditemukan untuk kueri DNS-SD.

otDnssdQuery

void otDnssdQuery

Jenis buram ini mewakili kueri DNS-SD.

otDnssdQuerySubscribeCallback

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

Fungsi ini dipanggil ketika kueri DNS-SD berlangganan salah satu dari:

  1. nama layanan.
  2. nama contoh layanan.
  3. nama host.

Implementasi kueri DNS-SD bertanggung jawab untuk mengidentifikasi apa itu aFullName . Jika aFullName adalah nama layanan atau nama instance layanan, implementasi kueri DNS-SD harus menemukan informasi instance layanan yang sesuai dan memberi tahu server DNS-SD menggunakan otDnssdQueryHandleDiscoveredServiceInstance . Jika aFullName adalah nama host, implementasi kueri DNS-SD harus menemukan informasi host dan memberi tahu server DNS-SD menggunakan otDnssdQueryHandleDiscoveredHost .

Detail
Parameter
[in] aContext
Penunjuk ke konteks khusus aplikasi.
[in] aFullName
Nama layanan lengkap yang dihentikan null (misalnya "_ipps._tcp.default.service.arpa."), Atau nama layanan lengkap (misalnya "OpenThread._ipps._tcp.default.service.arpa."), Atau nama host lengkap (mis. "ot-host.default.service.arpa.").
Lihat juga:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

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

Fungsi ini dipanggil saat kueri DNS-SD berhenti berlangganan salah satu dari:

  1. nama layanan.
  2. nama contoh layanan.
  3. nama host.

Implementasi kueri DNS-SD bertanggung jawab untuk mengidentifikasi apa itu aFullName .

Detail
Parameter
[in] aContext
Penunjuk ke konteks khusus aplikasi.
[in] aFullName
Nama layanan lengkap yang dihentikan null (misalnya "_ipps._tcp.default.service.arpa."), Atau nama layanan lengkap (misalnya "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Struktur ini mewakili informasi dari contoh layanan yang ditemukan untuk kueri DNS-SD.

Fungsi

otDnssdGetNextQuery

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

Fungsi ini mendapatkan kueri berikutnya di server DNS-SD.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aQuery
Penunjuk kueri. Lewati NULL untuk mendapatkan kueri pertama.
Kembali
Sebuah penunjuk ke kueri atau NULL jika tidak ada kueri lagi.

otDnssdGetQueryTypeAndName

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

Fungsi ini memperoleh jenis dan nama kueri DNS-SD untuk kueri tertentu.

Detail
Parameter
[in] aQuery
otDnssdGetNextQuery kueri diperoleh dari otDnssdGetNextQuery .
[out] aNameOutput
Buffer keluaran nama, yang harus OT_DNS_MAX_NAME_SIZE byte.
Kembali
Jenis kueri DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Fungsi ini memberi tahu host yang ditemukan.

Penyelesai kueri eksternal (mis. Discovery Proxy) harus memanggil fungsi ini untuk memberi tahu inti OpenThread dari host yang dilanggan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aHostFullName
Nama host lengkap dengan penghentian null.
[in] aHostInfo
Penunjuk ke informasi contoh layanan yang ditemukan.

otDnssdQueryHandleDiscoveredServiceInstance

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

Fungsi ini memberi tahu contoh layanan yang ditemukan.

Penyelesai kueri eksternal (mis. Discovery Proxy) harus memanggil fungsi ini untuk memberi tahu inti OpenThread dari layanan berlangganan atau contoh layanan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aServiceFullName
Nama layanan lengkap tanpa penghentian.
[in] aInstanceInfo
Penunjuk ke informasi contoh layanan yang ditemukan.

otDnssdQuerySetCallbacks

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

Fungsi ini menyetel panggilan balik kueri server DNS-SD.

Server DNS-SD memanggil aSubscribe untuk berlangganan layanan atau contoh layanan untuk menyelesaikan kueri DNS-SD dan aUnsubscribe untuk berhenti berlangganan ketika kueri diselesaikan atau waktu habis.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aSubscribe
Penunjuk ke fungsi panggilan balik untuk berlangganan layanan atau contoh layanan.
[in] aUnsubscribe
Penunjuk ke fungsi panggilan balik untuk berhenti berlangganan layanan atau contoh layanan.
[in] aContext
Penunjuk ke konteks khusus aplikasi.