IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
A solicitação IOCTL_BTH_SDP_ATTRIBUTE_SEARCH obtém atributos para o registro SDP especificado.
Código principal
Buffer de entrada
O membro AssociatedIrp.SystemBuffer contém um BTH_SDP_ATTRIBUTE_SEARCH_REQUEST estrutura que especifica o intervalo remoto de atributos do computador para pesquisar mais outros membros-chave.
Comprimento do buffer de entrada
O comprimento de um BTH_SDP_ATTRIBUTE_SEARCH_REQUEST estrutura.
Buffer de saída
O membro AssociatedIrp.SystemBuffer aponta para um buffer que contém uma estrutura BTH_SDP_STREAM_RESPONSE seguida por um fluxo de SDP bruto de comprimento variável.
Comprimento do buffer de saída
O comprimento de uma estrutura BTH_SDP_STREAM_RESPONSE .
Bloco de status
Se a solicitação for bem-sucedida, o membro Informações da estrutura STATUS_BLOCK será definido como o tamanho, em bytes, do BTH_SDP_STREAM_RESPONSE ou do tamanho do buffer de saída, o que for menor. Caso contrário, o membro Informações será definido como zero.
O membro Status é definido como um dos valores na tabela a seguir.
| Valor de status | Descrição |
|---|---|
| STATUS_SUCCESS | O IOCTL foi concluído com êxito. |
| STATUS_DEVICE_NOT_CONNECTED | O dispositivo no qual o serviço SDP reside não estava conectado. |
| STATUS_INSUFFICIENT_RESOURCES | Não havia memória suficiente para concluir esta operação. |
| STATUS_INVALID_BUFFER_SIZE | O buffer de saída foi dimensionado incorretamente. |
| STATUS_INVALID_PARAMETER | Um dos valores no buffer de entrada não era válido. |
| STATUS_REQUEST_NOT_ACCEPTED | O serviço SDP rejeitou a solicitação. |
| STATUS_TOO_MANY_GUIDS_REQUESTED | O serviço SDP não pôde processar o número de GUIDs passados no buffer de entrada. |
Comentários
Na maioria das circunstâncias, os drivers de perfil podem combinar pesquisas de atributo e serviço SDP chamando o IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL. Se um driver de perfil precisar reduzir a quantidade de tráfego SDP transmitido pelo link bluetooth ou extrair informações do servidor SDP usando um pequeno número de MTUs (unidades de transferência de mensagens), o driver de perfil deverá chamar o IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL para executar uma pesquisa de serviço. Em seguida, o driver de perfil deve chamar o IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL para executar uma pesquisa de atributo.
A estrutura BTH_SDP_STREAM_RESPONSE retornada no buffer de saída contém informações sobre o tamanho de todo o registro SDP, o tamanho, em bytes, do fluxo de registro SDP bruto que segue a estrutura de BTH_SDP_STREAM_RESPONSE e o primeiro byte desse fluxo. O fluxo de comprimento variável são os atributos de registro SDP retornados pela pesquisa.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Versões:_Supported no Windows Vista e posteriores. |
| Cabeçalho | bthioctl.h (inclua Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |