IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

Artikel
02/26/2024

Die IOCTL_BTH_SDP_ATTRIBUTE_SEARCH Anforderung ruft Attribute für den angegebenen SDP-Datensatz ab.

Hauptcode

Eingabepuffer

Das AssociatedIrp.SystemBuffer-Element enthält ein BTH_SDP_ATTRIBUTE_SEARCH_REQUEST Struktur, die den Bereich der zu durchsuchenden Attribute des Remotecomputers sowie andere Schlüsselmember angibt.

Eingabepufferlänge

Die Länge eines BTH_SDP_ATTRIBUTE_SEARCH_REQUEST Struktur.

Ausgabepuffer

Das AssociatedIrp.SystemBuffer-Element verweist auf einen Puffer, der eine BTH_SDP_STREAM_RESPONSE-Struktur enthält, gefolgt von einem unformatierten SDP-Stream mit variabler Länge.

Länge des Ausgabepuffers

Die Länge einer BTH_SDP_STREAM_RESPONSE Struktur.

Statusblock

Wenn die Anforderung erfolgreich ist, wird der Informationsmember der STATUS_BLOCK-Struktur auf die Größe des BTH_SDP_STREAM_RESPONSE oder der Größe des Ausgabepuffers in Bytes festgelegt, je nachdem, welcher Wert kleiner ist. Andernfalls wird das Element Information auf 0 festgelegt.

Das Statuselement ist auf einen der Werte in der folgenden Tabelle festgelegt.

Statuswert	BESCHREIBUNG
STATUS_SUCCESS	Das IOCTL wurde erfolgreich abgeschlossen.
STATUS_DEVICE_NOT_CONNECTED	Das Gerät, auf dem sich der SDP-Dienst befindet, war nicht verbunden.
STATUS_INSUFFICIENT_RESOURCES	Es war nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang abzuschließen.
STATUS_INVALID_BUFFER_SIZE	Die Größe des Ausgabepuffers war falsch.
STATUS_INVALID_PARAMETER	Einer der Werte im Eingabepuffer war ungültig.
STATUS_REQUEST_NOT_ACCEPTED	Der SDP-Dienst hat die Anforderung abgelehnt.
STATUS_TOO_MANY_GUIDS_REQUESTED	Der SDP-Dienst konnte die Anzahl der im Eingabepuffer übergebenen GUIDs nicht verarbeiten.

Hinweise

In den meisten Fällen können Profiltreiber SDP-Dienst- und Attributsuchen kombinieren, indem sie die IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL. Wenn ein Profiltreiber die Menge des SDP-Datenverkehrs reduzieren muss, der über den Bluetooth-Link übertragen wird, oder Informationen vom SDP-Server mithilfe einer kleinen Anzahl von Message Transfer Units (MTUs) extrahieren muss, sollte der Profiltreiber die IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL zum Ausführen einer Dienstsuche. Der Profiltreiber sollte dann den IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL aufrufen, um eine Attributsuche durchzuführen.

Die BTH_SDP_STREAM_RESPONSE-Struktur, die im Ausgabepuffer zurückgegeben wird, enthält Informationen über die Größe des gesamten SDP-Datensatzes, die Größe des unformatierten SDP-Datensatzdatenstroms in Bytes, der der BTH_SDP_STREAM_RESPONSE-Struktur folgt, und das erste Byte dieses Datenstroms. Der Stream mit variabler Länge ist die SDP-Datensatzattribute, die von der Suche zurückgegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Kopfzeile	bthioctl.h (einschließlich Bthioctl.h)
IRQL	<= PASSIVE_LEVEL