Paramètres de configuration

Le comportement de l' API du point de contrôle et de l’API de l' hôte du périphérique peut être modifié en modifiant les paramètres du Registre.

Sept valeurs de Registre affectent le comportement :

  • DownloadScope
  • DeviceLifeTime
  • \Hôte d’appareil UPnP \ Limite de taille de fichier
  • \Windows \ CurrentVersion \ UPnP \ Limite de taille de fichier
  • MaxCache
  • TTL
  • ReceiveScope

Il existe deux valeurs de Registre appelées limite de taille de fichier, une pour les documents de description et l’autre pour les réponses qui utilisent le protocole SOAP (Simple Object Access Protocol).

L’emplacement de chacune des sept valeurs dans le Registre est le suivant :

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

Descriptions des valeurs de Registre

Les valeurs de Registre sont expliquées dans la liste suivante. Chaque valeur de Registre est un nombre _ DWORD reg (un entier 32 bits). L’effet de chaque valeur est global.

DownloadScope

Spécifie les adresses IP valides pour l’URL du document de description de l’appareil. Si l’adresse IP de l’hôte spécifié dans l’URL du document de description ne se trouve pas dans l’étendue spécifiée par DownloadScope, cette adresse IP n’est pas valide et l’objet de l’appareil n’est pas créé.

Les valeurs valides sont indiquées dans le tableau suivant. La valeur par défaut est 1.

Valeur de DownloadScope Signification
0 L’adresse IP de l’hôte doit être une adresse de sous-réseau.
1 L’adresse IP de l’hôte doit être une adresse de sous-réseau ou une adresse privée de 10. x. x. x, 192,168. x. x, 172,16. x. x (comme spécifié par la norme RFC 1918) ou 169,254. x. x (comme spécifié par la norme RFC 3330).
2 L’adresse IP de l’hôte doit être une adresse de sous-réseau, une adresse privée ou une adresse qui se trouve dans les tronçons de durée de vie (TTL) du point de contrôle.
3 L’adresse IP de l’hôte peut être n’importe quelle adresse.
>3 Identique à celui de la valeur 0.

DeviceLifeTime

Facultatif. Spécifie la durée de vie d’un appareil, en secondes, qui remplace la valeur fournie dans le message d’annonce de l’appareil. Si DeviceLifeTime est présent, la valeur spécifiée dans l’annonce de l’appareil est ignorée et la valeur de Registre est utilisée à la place. Cela s’applique à tous les appareils.

Les valeurs valides sont comprises entre 900 et Max _ DWORD. La valeur par défaut est 1800. Si DeviceLifeTime est défini sur 0, la valeur par défaut est utilisée.

\Hôte d’appareil UPnP \ Limite de taille de fichier

Spécifie la taille maximale, en octets, de chaque document de description. ce paramètre n’est pas configurable dans les versions de Windows précédentes Windows XP Service Pack 2. Dans les versions précédentes, ce paramètre est codé en dur en tant que 102400.

Les valeurs valides sont comprises entre 10240 et Max _ DWORD. La valeur par défaut est 102400.

\Windows \ CurrentVersion \ UPnP \ Limite de taille de fichier

Spécifie la taille maximale, en octets, de la réponse SOAP acceptable. ce paramètre n’est pas configurable dans les versions de Windows précédentes Windows XP Service Pack 2. Dans les versions précédentes, ce paramètre est codé en dur en tant que 102400.

Les valeurs valides sont comprises entre 10240 et Max _ DWORD. La valeur par défaut est 102400.

MaxCache

Spécifie le nombre maximal d’entrées autorisées dans le cache SSDP (simple service Discovery Protocol).

Les valeurs valides sont comprises entre 10 et 30000. La valeur par défaut est 1000.

EXPIRATION

Spécifie la durée de vie d’un paquet SSDP. Autrement dit, la durée de vie spécifie le nombre de tronçons autorisés pour un paquet.

Les valeurs valides sont comprises entre 1 et 255. La valeur par défaut est 1.

ReceiveScope

Spécifie les adresses IP qui sont des sources valides d’un message. Si un message entrant provient d’une adresse qui ne se trouve pas dans l’étendue spécifiée par ReceiveScope, le message est ignoré. ce paramètre n’est pas configurable dans les versions de Windows précédentes Windows XP Service Pack 2. Dans les versions précédentes, un message est accepté sans tenir compte de sa source.

Les valeurs valides sont indiquées dans le tableau suivant. La valeur par défaut est 1.

Valeur de ReceiveScope Signification
0 L’adresse IP de l’expéditeur doit être une adresse de sous-réseau.
1 L’adresse IP de l’expéditeur doit être une adresse de sous-réseau ou une adresse privée de 10. x. x. x, 192,168. x. x, 172,16. x. x (comme spécifié par la norme RFC 1918) ou 169,254. x. x (comme spécifié par la norme RFC 3330).
2 Non utilisé. Si ReceiveScope a la valeur 2, la valeur par défaut est utilisée.
3 L’adresse IP de l’expéditeur peut être n’importe quelle adresse.

Vue d’ensemble de l’architecture UPnP