IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

Статья
02/06/2025

Запрос IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH объединяет службу SDP и поиск атрибутов в одну операцию. Это позволяет вызывающему объекту напрямую получать записи SDP с удаленного устройства.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Элемент AssociatedIrp.SystemBuffer содержит элемент IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH структура, указывающая дескриптор подключения к удаленному серверу SDP, массив идентификаторов GUID и диапазон значений атрибутов для поиска.

Длина входного буфера

Длина IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH структура.

Выходной буфер

Элемент AssociatedIrp.SystemBuffer указывает на буфер, содержащий структуру BTH_SDP_STREAM_RESPONSE, за которой следует необработанный поток записей SDP.

Длина выходного буфера

Длина BTH_SDP_STREAM_RESPONSE структуры.

Блок состояния

Если запрос выполнен успешно, information член структуры STATUS_BLOCK устанавливается в размер потока ответа SDP или размер выходного буфера, в зависимости от размера которого меньше. В противном случае элемент сведений равен нулю.

Элемент состояния имеет одно из значений в следующей таблице.

Значение состояния	Описание
STATUS_SUCCESS	IOCTL успешно завершен.
STATUS_DEVICE_NOT_CONNECTED	Устройство, на котором находится служба SDP, не подключено.
STATUS_INSUFFICIENT_RESOURCES	Для выполнения этой операции недостаточно памяти.
STATUS_INVALID_BUFFER_SIZE	Недопустимый размер выходного буфера.
STATUS_INVALID_PARAMETER	Одно из значений входного буфера недопустимо.
STATUS_REQUEST_NOT_ACCEPTED	Служба SDP отклонила запрос.
STATUS_TOO_MANY_GUIDS_REQUESTED	Служба SDP не могла обработать количество идентификаторов GUID, переданных в входной буфер.

Замечания

После получения записи SDP драйвер профиля может использовать функции SDP для их анализа. Указатели на эти функции предоставляются интерфейс BTHDDI_SDP_PARSE_INTERFACE.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Версии:_Supported в Windows Vista и более поздних версиях.
заголовка	bthioctl.h (include Bthioctl.h)
IRQL	<= PASSIVE_LEVEL