IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

Artículo
08/07/2023

La solicitud IOCTL_BTH_SDP_ATTRIBUTE_SEARCH obtiene atributos para el registro SDP especificado.

Código principal

Búfer de entrada

El miembro AssociatedIrp.SystemBuffer contiene un BTH_SDP_ATTRIBUTE_SEARCH_REQUEST estructura que especifica el intervalo remoto de atributos del equipo para buscar más otros miembros clave.

Longitud del búfer de entrada

Longitud de un BTH_SDP_ATTRIBUTE_SEARCH_REQUEST estructura.

Búfer de salida

El miembro AssociatedIrp.SystemBuffer apunta a un búfer que contiene una estructura de BTH_SDP_STREAM_RESPONSE seguida de una secuencia SDP sin formato de longitud variable.

Longitud del búfer de salida

Longitud de una estructura de BTH_SDP_STREAM_RESPONSE .

Bloque de estado

Si la solicitud se realiza correctamente, el miembro Information de la estructura de STATUS_BLOCK se establece en el tamaño, en bytes, del BTH_SDP_STREAM_RESPONSE o del tamaño del búfer de salida, lo que sea menor. De lo contrario, el miembro Information se establece en cero.

El miembro Status se establece en uno de los valores de la tabla siguiente.

Valor de estado	Descripción
STATUS_SUCCESS	El IOCTL se completó correctamente.
STATUS_DEVICE_NOT_CONNECTED	El dispositivo en el que reside el servicio SDP no estaba conectado.
STATUS_INSUFFICIENT_RESOURCES	No había suficiente memoria para completar esta operación.
STATUS_INVALID_BUFFER_SIZE	El tamaño del búfer de salida era incorrecto.
STATUS_INVALID_PARAMETER	Uno de los valores del búfer de entrada no era válido.
STATUS_REQUEST_NOT_ACCEPTED	El servicio SDP rechazó la solicitud.
STATUS_TOO_MANY_GUIDS_REQUESTED	El servicio SDP no pudo procesar el número de GUID pasados en el búfer de entrada.

Comentarios

En la mayoría de las circunstancias, los controladores de perfil pueden combinar el servicio SDP y las búsquedas de atributos mediante una llamada a . IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL. Si un controlador de perfil debe reducir la cantidad de tráfico SDP que se transmite a través del vínculo Bluetooth o extraer información del servidor SDP mediante un pequeño número de unidades de transferencia de mensajes (MTU), el controlador de perfil debe llamar al IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL para realizar una búsqueda de servicio. A continuación, el controlador de perfil debe llamar al IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL para realizar una búsqueda de atributos.

La estructura BTH_SDP_STREAM_RESPONSE devuelta en el búfer de salida contiene información sobre el tamaño de todo el registro SDP, el tamaño, en bytes, del flujo de registro SDP sin formato que sigue a la estructura BTH_SDP_STREAM_RESPONSE y el primer byte de esa secuencia. La secuencia de longitud variable es los atributos de registro SDP devueltos por la búsqueda.

Requisitos

Requisito	Value
Cliente mínimo compatible	Versions:_Supported en Windows Vista y versiones posteriores.
Encabezado	bthioctl.h (incluya Bthioctl.h)
IRQL	<= PASSIVE_LEVEL