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.