IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

Article
05/18/2021

The IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH request combines an SDP service and attribute search into a single operation. This allows a caller to directly obtain SDP records from a remote device.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

The AssociatedIrp.SystemBuffer member contains an IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH structure that specifies the connection handle to the remote SDP server, an array of GUIDs, and the range of attribute values to search for.

Input buffer length

The length of an IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH structure.

Output buffer

The AssociatedIrp.SystemBuffer member points to a buffer that holds a BTH_SDP_STREAM_RESPONSE structure followed by a raw SDP record 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 SDP response stream 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

After a profile driver obtains an SDP record, it can use SDP functions to parse them. Pointers to these functions are provided by the BTHDDI_SDP_PARSE_INTERFACE interface.

Requirements

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