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
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 |