Server DNS-SD
Questo modulo include API per il server DNS-SD.
Riepilogo
Enumerazioni |
|
---|---|
otDnssdQueryType{
|
enum Questa enumerazione specifica un tipo di query DNS-SD. |
Defdef |
|
---|---|
otDnssdCounters
|
tipodefstruct otDnssdCounters
Questa struttura contiene i contatori del server DNS-SD. |
otDnssdHostInfo
|
tipodefstruct otDnssdHostInfo
Questa struttura rappresenta le informazioni di un host rilevato per una query DNS-SD. |
otDnssdQuery
|
tipodefvoid
Questo tipo opaco rappresenta una query DNS-SD. |
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
|
tipodefvoid(*
Questa funzione viene chiamata quando una query DNS-SD sottoscrive uno dei seguenti protocolli: |
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
|
tipodefvoid(*
Questa funzione viene chiamata quando una query DNS-SD annulla l'iscrizione di una delle seguenti opzioni: |
otDnssdServiceInstanceInfo
|
tipodefstruct otDnssdServiceInstanceInfo
Questa struttura rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD. |
Functions |
|
---|---|
otDnssdGetCounters(otInstance *aInstance)
|
const otDnssdCounters *
Questa funzione restituisce i contatori del server DNS-SD.
|
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
|
const otDnssdQuery *
Questa funzione acquisisce la query successiva nel server DNS-SD.
|
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
|
Questa funzione acquisisce il tipo e il nome della query DNS-SD per una query specifica.
|
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
|
void
Questa funzione invia una notifica a un host rilevato.
|
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
|
void
Questa funzione invia una notifica a un'istanza di servizio rilevata.
|
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
|
void
Questa funzione imposta i callback delle query server DNS-SD.
|
Strutture |
|
---|---|
otDnssdCounters |
Questa struttura contiene i contatori del server DNS-SD. |
otDnssdHostInfo |
Questa struttura rappresenta le informazioni di un host rilevato per una query DNS-SD. |
otDnssdServiceInstanceInfo |
Questa struttura rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD. |
Enumerazioni
Tipo di query otDnssd
otDnssdQueryType
Questa enumerazione specifica un tipo di query DNS-SD.
Proprietà | |
---|---|
OT_DNSSD_QUERY_TYPE_BROWSE
|
Tipo di servizio Sfoglia servizio. |
OT_DNSSD_QUERY_TYPE_NONE
|
Tipo di servizio non specificato. |
OT_DNSSD_QUERY_TYPE_RESOLVE
|
Il tipo di servizio risolve l'istanza di servizio. |
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST
|
Il tipo di servizio risolve il nome host. |
Defdef
OtDnssdCounters
struct otDnssdCounters otDnssdCounters
Questa struttura contiene i contatori del server DNS-SD.
otDnssdHostInfo
struct otDnssdHostInfo otDnssdHostInfo
Questa struttura rappresenta le informazioni di un host rilevato per una query DNS-SD.
otDnssdQuery
void otDnssdQuery
Questo tipo opaco rappresenta una query DNS-SD.
otDnssdQueryIscriviti per richiamare
void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
Questa funzione viene chiamata quando una query DNS-SD sottoscrive uno dei seguenti protocolli:
- un nome per il servizio.
- un nome di istanza di servizio.
- un nome host.
L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName
. Se aFullName
è un nome di servizio o il nome di un'istanza di servizio, l'implementazione della query DNS-SD dovrebbe scoprire le informazioni sull'istanza di servizio corrispondenti e informare il server DNS-SD utilizzando otDnssdQueryHandleDiscoveredServiceInstance
. Se aFullName
è un nome host, l'implementazione della query DNS-SD dovrebbe scoprire le informazioni sull'host e informare il server DNS-SD utilizzando otDnssdQueryHandleDiscoveredHost
.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost
otDnssdQueryAnnulla la richiamata
void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
Questa funzione viene chiamata quando una query DNS-SD annulla l'iscrizione di una delle seguenti opzioni:
- un nome per il servizio.
- un nome di istanza di servizio.
- un nome host.
L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName
.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otDnssdServiceInstanceInfo
struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo
Questa struttura rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.
Functions
OtDnssdGetCounter
const otDnssdCounters * otDnssdGetCounters( otInstance *aInstance )
Questa funzione restituisce i contatori del server DNS-SD.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Un puntatore sui contatori del server DNS-SD.
|
otDnssdGetNextQuery
const otDnssdQuery * otDnssdGetNextQuery( otInstance *aInstance, const otDnssdQuery *aQuery )
Questa funzione acquisisce la query successiva nel server DNS-SD.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Restituisce |
Un puntatore alla query o NULL, se non ci sono più query.
|
otDnssdGetQueryTypeAndName
otDnssdQueryType otDnssdGetQueryTypeAndName( const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE] )
Questa funzione acquisisce il tipo e il nome della query DNS-SD per una query specifica.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Restituisce |
Il tipo di query DNS-SD.
|
otDnssdQueryHandleDiscoveredHost
void otDnssdQueryHandleDiscoveredHost( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo )
Questa funzione invia una notifica a un host rilevato.
Il resolver della query esterna (ad esempio Discovery Proxy) deve chiamare questa funzione per inviare una notifica al core OpenThread degli host a cui hai effettuato l'iscrizione.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
otDnssdQueryHandleDiscoveredServiceInstance
void otDnssdQueryHandleDiscoveredServiceInstance( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo )
Questa funzione invia una notifica a un'istanza di servizio rilevata.
Il resolver query esterno (ad esempio Discovery Proxy) deve chiamare questa funzione per notificare il core OpenThread dei servizi o delle istanze di servizio in abbonamento.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
otDnssdQuerySetCallbacks
void otDnssdQuerySetCallbacks( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext )
Questa funzione imposta i callback delle query server DNS-SD.
Il server DNS-SD chiama aSubscribe
per iscriversi a un servizio o un'istanza di servizio per risolvere una query DNS-SD e aUnsubscribe
per annullare l'iscrizione quando la query viene risolta o scade.
Dettagli | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parametri |
|
Risorse
Gli argomenti di riferimento per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per ulteriori informazioni o per contribuire alla nostra documentazione, consulta la sezione Risorse.