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 |