Compartilhar via


IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

A solicitação IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH combina um serviço SDP e uma pesquisa de atributo em uma única operação. Isso permite que um chamador obtenha registros SDP diretamente de um dispositivo remoto.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O membro AssociatedIrp.SystemBuffer contém um IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH estrutura que especifica o identificador de conexão para o servidor SDP remoto, uma matriz de GUIDs e o intervalo de valores de atributo a serem pesquisados.

Comprimento do buffer de entrada

O comprimento de um IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH 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 registro SDP bruto.

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 Information da estrutura STATUS_BLOCK será definido como o tamanho, em bytes, do fluxo de resposta SDP ou o 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

Depois que um driver de perfil obtém um registro SDP, ele pode usar funções SDP para analisá-los. Os ponteiros para essas funções são fornecidos pelo interface BTHDDI_SDP_PARSE_INTERFACE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Versões:_Supported no Windows Vista e posterior.
Cabeçalho bthioctl.h (include Bthioctl.h)
IRQL <= PASSIVE_LEVEL

Confira também

BTHDDI_SDP_PARSE_INTERFACE

BTH_SDP_STREAM_RESPONSE

IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH