IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

Die IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH Anforderung kombiniert eine SDP-Dienst- und Attributsuche in einem einzelnen Vorgang. Dadurch kann ein Aufrufer SDP-Datensätze direkt von einem Remotegerät abrufen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Das AssociatedIrp.SystemBuffer-Element enthält einen IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH Struktur, die das Verbindungshandle mit dem Remote-SDP-Server, ein Array von GUIDs und den Bereich der zu suchenden Attributwerte angibt.

Eingabepufferlänge

Die Länge eines IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH Struktur.

Ausgabepuffer

Das AssociatedIrp.SystemBuffer-Element verweist auf einen Puffer, der eine BTH_SDP_STREAM_RESPONSE-Struktur enthält, gefolgt von einem unformatierten SDP-Datensatzdatenstrom.

Länge des Ausgabepuffers

Die Länge einer BTH_SDP_STREAM_RESPONSE Struktur.

Statusblock

Wenn die Anforderung erfolgreich ist, wird das Informationselement der STATUS_BLOCK-Struktur auf die Größe des SDP-Antwortdatenstroms in Bytes oder die Größe des Ausgabepuffers 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

Nachdem ein Profiltreiber einen SDP-Eintrag abgerufen hat, kann er sie mithilfe von SDP-Funktionen analysieren. Zeiger auf diese Funktionen werden vom BTHDDI_SDP_PARSE_INTERFACE Schnittstelle.

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

Weitere Informationen

BTHDDI_SDP_PARSE_INTERFACE

BTH_SDP_STREAM_RESPONSE

IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH