Función SdpCreateNodeTree (sdplib.h)
La función Bluetooth SdpCreateNodeTree se usa para asignar una estructura raíz vacía SDP_TREE_ROOT_NODE .
Sintaxis
PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
[in] ULONG tag
);
Parámetros
[in] tag
Etiqueta definida por el controlador de perfil que se va a asociar al nodo.
Valor devuelto
Si se ejecuta correctamente, esta función devuelve un puntero a la estructura de SDP_TREE_ROOT_NODE recién asignada. Si no se ejecuta correctamente, esta función devuelve NULL.
Comentarios
Llamar a la función SdpCreateNodeTree es el primer paso para crear un árbol SDP. Después de que un controlador de perfil de Bluetooth asigne un nodo raíz mediante esta función, el nodo se puede rellenar mediante llamadas a otras funciones a las que apunta el BTHDDI_SDP_NODE_INTERFACE estructura.
Cuando ya no se necesita un árbol SDP, el controlador de perfil bluetooth debe destruirlo llamando a la función SdpFreeTree . SdpFreeTree libera el nodo raíz y todos los nodos secundarios que se han asociado a él. Las estructuras de SDP_NODE individuales se pueden liberar llamando a la rutina de soporte del controlador ExFreePool siempre que ya no formen parte de un árbol u otra lista.
Los controladores de perfil bluetooth pueden obtener un puntero a esta función a través de la estructura BTHDDI_SDP_NODE_INTERFACE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Versions:_Supported en Windows Vista y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Encabezado | sdplib.h (incluya BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |