配置设置

可以通过更改注册表中的设置来修改 控制点 API设备主机 API 的行为。

有七个影响行为的注册表值:

  • DownloadScope
  • DeviceLifeTime
  • \ UPnP 设备主机\文件大小限制
  • \ Windows\CurrentVersion\UPnP\文件大小限制
  • MaxCache
  • TTL
  • ReceiveScope

有两个注册表值称为 文件大小限制,一个用于说明文档,另一个用于使用简单对象访问协议(SOAP)的响应。

注册表中七个值中每个值的位置如下所示:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         UPnPControl Point
            DownloadScope
         UPnP Device Host
            Devices
               DeviceLifeTime
            File Size Limit
         Windows
            CurrentVersion
               UPnP
                  File Size Limit
   SYSTEM
      CurentControlSet
         Services
            SSDPSRV
               Parameters
                  MaxCache
                  TTL
                  ReceiveScope

注册表值说明

以下列表中介绍了注册表值。 每个注册表值都是 REG_DWORD(32 位整数)。 每个值的效果都是全局的。

DownloadScope

指定哪些 IP 地址对设备说明文档 URL 有效。 如果在说明文档 URL 中指定的主机的 IP 地址不在 DownloadScope指定的范围内,则 IP 地址无效,并且不会创建设备对象。

下表显示了有效值。 默认值为 1。

DownloadScope 的值 意义
0 主机的 IP 地址必须是子网地址。
1 主机的 IP 地址必须是子网地址或专用地址,该地址是 10 之一。xxx,192.168。xx,172.16。xx(由 RFC 1918 指定)或 169.254。xx(由 RFC 3330 指定)。
2 主机的 IP 地址必须是子网地址、专用地址或控制点中生存时间(TTL)跃点内的地址。
3 主机的 IP 地址可以是任何地址。
>3 与值 0 相同。

 

DeviceLifeTime

自选。 指定设备的生存期(以秒为单位),该值覆盖设备公告消息中提供的值。 如果存在 DeviceLifeTime,则会忽略设备公告中指定的值,并改用注册表值。 这适用于所有设备。

有效值范围为 900 到 MAX_DWORD。 默认值为 1800。 如果 DeviceLifeTime 设置为 0,则使用默认值。

\ UPnP 设备主机\文件大小限制

指定每个说明文档的最大大小(以字节为单位)。 此设置在 Windows XP Service Pack 2 之前的 Windows 版本中不可配置。 在以前的版本中,此设置硬编码为 102400。

有效值范围为 10240 到 MAX_DWORD。 默认值为 102400。

\ Windows\CurrentVersion\UPnP\文件大小限制

指定可接受的 SOAP 响应的最大大小(以字节为单位)。 此设置在 Windows XP Service Pack 2 之前的 Windows 版本中不可配置。 在以前的版本中,此设置硬编码为 102400。

有效值范围为 10240 到 MAX_DWORD。 默认值为 102400。

MaxCache

指定简单服务发现协议 (SSDP) 缓存中允许的最大条目数。

有效值范围为 10 到 30000。 默认值为 1000。

TTL

指定 SSDP 数据包的生存时间。 也就是说,TTL 指定数据包允许的跃点数。

有效值范围为 1 到 255。 默认值为 1。

ReceiveScope

指定哪些 IP 地址是消息的有效源。 如果传入消息源自不在 ReceiveScope指定的范围内地址,则忽略该消息。 此设置在 Windows XP Service Pack 2 之前的 Windows 版本中不可配置。 在以前的版本中,无论消息的源如何,都将被接受。

下表显示了有效值。 默认值为 1。

ReceiveScope 的值 意义
0 发件人的 IP 地址必须是子网地址。
1 发件人的 IP 地址必须是子网地址或专用地址(10 之一)。xxx,192.168。xx,172.16。xx(由 RFC 1918 指定)或 169.254。xx(由 RFC 3330 指定)。
2 未使用。 如果 ReceiveScope 设置为 2,则使用默认值。
3 发件人的 IP 地址可以是任何地址。

 

UPnP 体系结构 概述