PCONVERTTREETOSTREAM-Rückruffunktion (bthsdpddi.h)

Die Bluetooth SdpConvertTreeToStream-Funktion wird verwendet, um eine unformatierte Bytestreamdarstellung eines SDP-Datensatzes aus einer Strukturdarstellung zu erzeugen. Die Raw-Bytestream-Version eignet sich für die Veröffentlichung auf einem lokalen SDP-Server.

Syntax

PCONVERTTREETOSTREAM Pconverttreetostream;

NTSTATUS Pconverttreetostream(
  PSDP_TREE_ROOT_NODE Root,
  PUCHAR *Stream,
  PULONG Size,
  ULONG tag
)
{...}

Parameter

Root

Der Stammknoten der strukturbasierten Darstellung des SDP-Datensatzes, der in eine streambasierte Darstellung konvertiert werden soll.

Stream

Ein Zeiger auf den Puffer, der den konvertierten SDP-Stream empfängt.

Size

Die Adresse einer ganzzahligen Zahl ohne Vorzeichen, um die Länge des konvertierten SDP-Datenstroms zu empfangen.

tag

Gibt ein 4-Byte-Pooltag an , das den Treiber eindeutig identifiziert, der die Speicherzuordnung übernimmt. Weitere Informationen zu Pooltags finden Sie unter ExAllocatePoolWithTag.

Rückgabewert

Mögliche Rückgabewerte sind:

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Hinweise

Die SdpConvertTreeToStream-Funktion führt den entgegengesetzten Vorgang als SdpConvertStreamToTree-Funktion aus. Es generiert einen vollständigen nativen SDP-Eintrag aus einer Microsoft-spezifischen Struktur. Treiberentwickler finden es möglicherweise bequemer, einen SDP-Datensatz als Struktur zu erstellen und ihn dann vor der Veröffentlichung in einen Stream zu konvertieren.

SdpConvertTreeToStream weist den erforderlichen Arbeitsspeicher zu, um die Streamversion des SDP-Datensatzes zu speichern. Wenn der Arbeitsspeicher nicht mehr benötigt wird, ist der Aufrufer für die Freigabe des Arbeitsspeichers mit der ExFreePool-Treiberunterstützungsroutine verantwortlich.

Bluetooth-Profiltreiber können einen Zeiger auf diese Funktion über die BTHDDI_SDP_PARSE_INTERFACE abrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Zielplattform	Desktop
Kopfzeile	bthsdpddi.h (include BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL

Weitere Informationen

BTHDDI_SDP_PARSE_INTERFACE

ExFreePool

SdpConvertStreamToTree