Fonction de rappel PCONVERTTREETOSTREAM (bthsdpddi.h)

La fonction Bluetooth SdpConvertTreeToStream est utilisée pour produire une représentation bytestream brute d’un enregistrement SDP à partir d’une représentation d’arborescence. La version brute bytestream est adaptée à la publication sur un serveur SDP local.

Syntaxe

PCONVERTTREETOSTREAM Pconverttreetostream;

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

Paramètres

Root

Nœud racine de la représentation basée sur une arborescence de l’enregistrement SDP à convertir en une représentation basée sur un flux.

Stream

Pointeur vers la mémoire tampon qui reçoit le flux SDP converti.

Size

Adresse d’un entier long non signé pour recevoir la longueur du flux SDP converti.

tag

Spécifie une balise de pool de 4 octets qui identifie de manière unique le pilote qui effectue l’allocation de mémoire. Pour plus d’informations sur les balises de pool, consultez ExAllocatePoolWithTag.

Valeur retournée

Les valeurs de retour possibles sont les suivantes :

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Remarques

La fonction SdpConvertTreeToStream effectue l’opération opposée en tant que fonction SdpConvertStreamToTree . Il génère un enregistrement SDP natif complet à partir d’une arborescence spécifique à Microsoft. Les développeurs de pilotes peuvent trouver plus pratique de créer un enregistrement SDP sous forme d’arborescence, puis de le convertir en flux avant de le publier.

SdpConvertTreeToStream alloue la mémoire nécessaire pour stocker la version de flux de l’enregistrement SDP. Lorsque la mémoire n’est plus nécessaire, l’appelant est chargé de libérer la mémoire à l’aide de la routine de prise en charge du pilote ExFreePool .

Les pilotes de profil Bluetooth peuvent obtenir un pointeur vers cette fonction via le BTHDDI_SDP_PARSE_INTERFACE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Versions :_Supported dans Windows Vista et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	bthsdpddi.h (include BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL

Voir aussi

BTHDDI_SDP_PARSE_INTERFACE

ExFreePool

SdpConvertStreamToTree