Servidor DNS-SD
Este módulo inclui APIs para servidor DNS-SD.
Resumo
Enumerações | |
---|---|
otDnssdQueryType { | enumerar Essa enumeração especifica um tipo de consulta DNS-SD. |
Typedefs | |
---|---|
otDnssdHostInfo | typedefstruct otDnssdHostInfo Essa estrutura representa informações de um host descoberto para uma consulta DNS-SD. |
otDnssdQuery | typedefvoid Esse tipo opaco representa uma consulta DNS-SD. |
otDnssdQuerySubscribeCallback )(void *aContext, const char *aFullName) | typedefvoid(* Esta função é chamada quando uma consulta DNS-SD inscreve um dos seguintes: |
otDnssdQueryUnsubscribeCallback )(void *aContext, const char *aFullName) | typedefvoid(* Essa função é chamada quando uma consulta DNS-SD cancela a assinatura de um dos seguintes: |
otDnssdServiceInstanceInfo | typedefstruct otDnssdServiceInstanceInfo Essa estrutura representa informações de uma instância de serviço descoberta para uma consulta DNS-SD. |
Funções | |
---|---|
otDnssdGetNextQuery ( otInstance *aInstance, const otDnssdQuery *aQuery) | const otDnssdQuery * Esta função adquire a próxima consulta no servidor DNS-SD. |
otDnssdGetQueryTypeAndName (const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]) | Esta função adquire o tipo de consulta DNS-SD e o nome de uma consulta específica. |
otDnssdQueryHandleDiscoveredHost ( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo) | void Esta função notifica um host descoberto. |
otDnssdQueryHandleDiscoveredServiceInstance ( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo) | void Essa função notifica uma instância de serviço descoberta. |
otDnssdQuerySetCallbacks ( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext) | void Esta função define os retornos de chamada de consulta do servidor DNS-SD. |
Estruturas | |
---|---|
otDnssdHostInfo | Essa estrutura representa informações de um host descoberto para uma consulta DNS-SD. |
otDnssdServiceInstanceInfo | Essa estrutura representa informações de uma instância de serviço descoberta para uma consulta DNS-SD. |
Enumerações
otDnssdQueryType
otDnssdQueryType
Essa enumeração especifica um tipo de consulta DNS-SD.
Typedefs
otDnssdHostInfo
struct otDnssdHostInfo otDnssdHostInfo
Essa estrutura representa informações de um host descoberto para uma consulta DNS-SD.
otDnssdQuery
void otDnssdQuery
Esse tipo opaco representa uma consulta DNS-SD.
otDnssdQuerySubscribeCallback
void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
Esta função é chamada quando uma consulta DNS-SD inscreve um dos seguintes:
- um nome de serviço.
- um nome de instância de serviço.
- um nome de host.
A implementação da consulta DNS-SD é responsável por identificar o que é aFullName
. Se aFullName
for um nome de serviço ou um nome de instância de serviço, a implementação da consulta DNS-SD deverá descobrir as informações da instância de serviço correspondente e notificar o servidor DNS-SD usando otDnssdQueryHandleDiscoveredServiceInstance
. Se aFullName
for um nome de host, a implementação da consulta DNS-SD deverá descobrir as informações do host e notificar o servidor DNS-SD usando otDnssdQueryHandleDiscoveredHost
.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
|
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost
otDnssdQueryUnsubscribeCallback
void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
Essa função é chamada quando uma consulta DNS-SD cancela a assinatura de um dos seguintes:
- um nome de serviço.
- um nome de instância de serviço.
- um nome de host.
A implementação da consulta DNS-SD é responsável por identificar o que é aFullName
.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
|
otDnssdServiceInstanceInfo
struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo
Essa estrutura representa informações de uma instância de serviço descoberta para uma consulta DNS-SD.
Funções
otDnssdGetNextQuery
const otDnssdQuery * otDnssdGetNextQuery( otInstance *aInstance, const otDnssdQuery *aQuery )
Esta função adquire a próxima consulta no servidor DNS-SD.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Devoluções | Um ponteiro para a consulta ou NULL se não houver mais consultas. |
otDnssdGetQueryTypeAndName
otDnssdQueryType otDnssdGetQueryTypeAndName( const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE] )
Esta função adquire o tipo de consulta DNS-SD e o nome de uma consulta específica.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Devoluções | O tipo de consulta DNS-SD. |
otDnssdQueryHandleDiscoveredHost
void otDnssdQueryHandleDiscoveredHost( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo )
Esta função notifica um host descoberto.
O resolvedor de consulta externo (por exemplo, Discovery Proxy) deve chamar esta função para notificar o núcleo OpenThread dos hosts inscritos.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
|
otDnssdQueryHandleDiscoveredServiceInstance
void otDnssdQueryHandleDiscoveredServiceInstance( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo )
Essa função notifica uma instância de serviço descoberta.
O resolvedor de consulta externo (por exemplo, Discovery Proxy) deve chamar essa função para notificar o núcleo OpenThread dos serviços ou instâncias de serviço inscritos.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
|
otDnssdQuerySetCallbacks
void otDnssdQuerySetCallbacks( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext )
Esta função define os retornos de chamada de consulta do servidor DNS-SD.
O servidor DNS-SD chama aSubscribe
para assinar um serviço ou instância de serviço para resolver uma consulta DNS-SD e aUnsubscribe
para cancelar a assinatura quando a consulta for resolvida ou atingir o tempo limite.
Detalhes | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parâmetros |
|
Recursos
Os tópicos de referência da API OpenThread se originam do código-fonte, disponível no GitHub . Para obter mais informações ou contribuir com nossa documentação, consulte Recursos .