IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

Article
05/18/2021

The IOCTL_BTH_SDP_ATTRIBUTE_SEARCH request obtains attributes for the specified SDP record.

Major code

Input buffer

The AssociatedIrp.SystemBuffer member contains a BTH_SDP_ATTRIBUTE_SEARCH_REQUEST structure that specifies the remote computer range of attributes to search plus other key members.

Input buffer length

The length of a BTH_SDP_ATTRIBUTE_SEARCH_REQUEST structure.

Output buffer

The AssociatedIrp.SystemBuffer member points to a buffer that contains a BTH_SDP_STREAM_RESPONSE structure that is followed by a variable-length raw SDP stream.

Output buffer length

The length of a BTH_SDP_STREAM_RESPONSE structure.

Status block

If the request is successful, the Information member of the STATUS_BLOCK structure is set to the size, in bytes, of the BTH_SDP_STREAM_RESPONSE or the size of the output buffer, whichever is smaller. Otherwise, the Information member is set to zero.

The Status member is set to one of the values in the following table.

Status value	Description
STATUS_SUCCESS	The IOCTL completed successfully.
STATUS_DEVICE_NOT_CONNECTED	The device on which the SDP service resides was not connected.
STATUS_INSUFFICIENT_RESOURCES	There was not enough memory to complete this operation.
STATUS_INVALID_BUFFER_SIZE	The output buffer was sized incorrectly.
STATUS_INVALID_PARAMETER	One of the values in the input buffer was not valid.
STATUS_REQUEST_NOT_ACCEPTED	The SDP service rejected the request.
STATUS_TOO_MANY_GUIDS_REQUESTED	The SDP service could not process the number of GUIDs passed in the input buffer.

Remarks

In most circumstances, profile drivers can combine SDP service and attribute searches by calling the IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL. If a profile driver must reduce the amount of SDP traffic that is transmitted over the Bluetooth link, or extract information from the SDP server by using a small number of message transfer units (MTUs), the profile driver should call the IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL to perform a service search. The profile driver should then call the IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL to perform an attribute search.

The BTH_SDP_STREAM_RESPONSE structure returned in the output buffer contains information about the size of the entire SDP record, the size, in bytes, of the raw SDP record stream that follows the BTH_SDP_STREAM_RESPONSE structure, and the first byte of that stream. The variable-length stream is the SDP record attributes returned by the search.

Requirements

Requirement	Value
Minimum supported client	Versions:_Supported in Windows Vista, and later.
Header	bthioctl.h (include Bthioctl.h)
IRQL	<= PASSIVE_LEVEL