IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
Die IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH-Anforderung kombiniert einen SDP-Dienst und eine Attributsuche in einem einzigen Vorgang. Dadurch kann ein Aufrufer SDP-Datensätze direkt von einem Remotegerät abrufen.
Hauptcode
Eingabepuffer
Das AssociatedIrp.SystemBuffer Member 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 suchden Attributwerte angibt.
Eingabepufferlänge
Die Länge einer IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH Struktur.
Ausgabepuffer
Der AssociatedIrp.SystemBuffer Member 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 Information Member der STATUS_BLOCK-Struktur auf die Größe des SDP-Antwortdatenstroms oder auf die Größe des Ausgabepuffers festgelegt, je nachdem, welcher Wert kleiner ist. Andernfalls wird der Information Member auf Null festgelegt.
Der Status Member wird auf einen der Werte in der folgenden Tabelle festgelegt.
| Statuswert | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die 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 | Der Ausgabepuffer wurde falsch angepasst. |
| 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. |
Bemerkungen
Nachdem ein Profiltreiber einen SDP-Eintrag abruft, kann er SDP-Funktionen verwenden, um ihn zu analysieren. Zeiger auf diese Funktionen werden vom BTHDDI_SDP_PARSE_INTERFACE Schnittstelle.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Versionen:_Supported in Windows Vista und höher. |
| Header- | bthioctl.h (include Bthioctl.h) |
| IRQL- | <= PASSIVE_LEVEL |