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 diretamente registros SDP de um dispositivo remoto.
Código principal
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 Information membro 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 de Informações do será definido como zero.
O membro status é definido como um dos valores na tabela a seguir.
| Valor do 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. |
Observações
Depois que um driver de perfil obtém um registro SDP, ele pode usar funções SDP para analisá-las. Os ponteiros para essas funções são fornecidos pelo BTHDDI_SDP_PARSE_INTERFACE interface.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Versões:_Supported no Windows Vista e posterior. |
| cabeçalho | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |