Función SdpCreateNodeTree (sdplib.h)
La función bluetooth SdpCreateNodeTree se usa para asignar una estructura de SDP_TREE_ROOT_NODE raíz vacía.
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.
Observaciones
Llamar a la función SdpCreateNodeTree de 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 compatibilidad 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 | Valor |
|---|---|
| cliente mínimo admitido | Versiones: _Supported en Windows Vista y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| encabezado de | sdplib.h (incluya BthSdpddi.h) |
| irQL | <= PASSIVE_LEVEL |