Fonction de rappel PCONVERTTREETOSTREAM (bthsdpddi.h)
La fonction Bluetooth SdpConvertTreeToStream est utilisée pour produire une représentation d’octet brut d’un enregistrement SDP à partir d’une représentation d’arborescence. La version brute d’octets convient à 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 l’arborescence de l’enregistrement SDP à convertir en 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 de retour
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 générer un enregistrement SDP en tant qu’arborescence, puis de le convertir en flux avant la publication.
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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | bthsdpddi.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |