SdpCreateNodeUrl 函数 (sdplib.h)
蓝牙 SdpCreateNodeUrl 函数用于为 URL 类型分配和初始化 SDP_NODE 结构。
语法
PSDP_NODE SdpCreateNodeUrl(
[in] PCHAR url,
ULONG urlLength,
[in] ULONG tag
);
参数
[in] url
指向用于初始化SDP_NODE结构的 URL 值的指针。
urlLength
一个无符号长整数值,用于保存 URL 的长度。
[in] tag
要与节点关联的配置文件驱动程序定义的标记。
返回值
如果成功,此函数将返回指向新分配的SDP_NODE结构的指针。 如果未成功,此函数将返回 NULL。
注解
在 SdpCreateNodeUrl 函数分配SDP_NODE结构后,它会通过以下方式初始化结构。
它可确保正确设置SDP_NODE结构的数据类型和数据大小字段。
它确保将关联的 SDP_NODE_HEADER 结构的指针成员初始化为指向节点本身。 这会创建一个仅包含一个元素的有效列表。
它可确保将传递给函数 的值 参数复制到 与 SDP_NODE 结构关联的SDP_NODE_DATA联合的相应元素。
与 SdpCreateNodeUrl 函数关联的数据将复制到节点中,并且可以随时释放原始数据。
蓝牙配置文件驱动程序可以通过 获取指向此函数的指针 BTHDDI_SDP_NODE_INTERFACE 结构。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 版本:Windows Vista 及更高版本中的 _Supported。 |
目标平台 | 桌面 |
标头 | sdplib.h (包括 BthSdpddi.h) |
IRQL | <= PASSIVE_LEVEL |