IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
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 |