Inscription aux options d’ergonomie des technologies d’assistance

Cet article explique comment inscrire une application d’accessibilité auprès du Centre d’ergonomie. Il explique également comment personnaliser votre application d’accessibilité pour qu’elle fonctionne correctement avec le bureau sécurisé.

Le Centre d’ergonomie est une application Panneau de configuration pour Microsoft Windows qui regroupe des fonctionnalités d’accessibilité et de facilité d’utilisation. À l’aide du Centre d’ergonomie, les utilisateurs peuvent configurer leurs ordinateurs en fonction de leurs besoins physiques et cognitifs.

L’une des fonctions du Centre d’ergonomie est d’aider les utilisateurs à lancer des applications d’accessibilité, notamment le Narrateur, le clavier visuel et la Loupe. Les applications tierces inscrites apparaissent également dans le Centre d’ergonomie et peuvent être lancées directement à partir de cet emplacement.

Les applications d’accessibilité doivent fonctionner sans problème avec le bureau sécurisé. Le bureau sécurisé est l’interface utilisateur qui s’affiche lorsque l’ordinateur est verrouillé (lors de la connexion ou lorsque l’utilisateur a verrouillé le bureau) et lorsque l’utilisateur est invité à autoriser une action potentiellement dangereuse. Pour des raisons de sécurité, Windows impose des limites aux logiciels tiers exécutés sur le bureau sécurisé. Si vous souhaitez que votre application d’accessibilité s’exécute sur le bureau sécurisé, vous devez inscrire l’application auprès du Centre d’ergonomie.

Inscription auprès du Centre d’ergonomie

Les applications d’accessibilité s’inscrivent auprès du Centre d’ergonomie en créant une ou plusieurs clés de Registre lors de l’installation de l’application. Le tableau suivant répertorie les informations contenues dans les clés de Registre.

Localisation

Les valeurs de Registre nom et description de l’application doivent être localisables pour prendre en charge l’interface utilisateur multilingue (MUI).

Ces chaînes sont au format suivant, où les crochets d’angle signifient les éléments requis et les crochets signifient un élément facultatif.

@<ResDllPath\ResDLLFilename>,-<resID>[;< comment>]

<ResDllPath\ResDLLFilename> est le chemin d’accès à la DLL de ressource. Le chemin d’accès peut contenir des variables d’environnement.

<resID> est l’ID de ressource de la chaîne.

[comment] contient tous les commentaires facultatifs.

Voici un exemple :

@%SystemRoot%\system32\anyAT.dll,-5020

Pour plus d’informations sur muI, consultez Centre de connaissances Windows MUI.

Profil HCI

Le profil Human Computer Interaction (HCI) est un moyen de déterminer les aménagements à fournir en fonction des besoins de l’utilisateur. Les applications d’accessibilité doivent enregistrer des informations sur le type de handicap que l’application aide à prendre en charge.

La valeur du Registre profil contient du code XML qui décrit le type de handicap ciblé par l’application d’accessibilité. Ce code XML a le format suivant :

<HCIModel>
<Accommodation type="disability"/>
</HCIModel>

Les valeurs valides pour l’attribut de type Accommodation sont les suivantes :

• vision légère
• vision sévère
• cognitive légère
• cognitive grave
• légère dextérité
• dextérité grave
• ouïe légère
• ouïe grave
• voix légère
• voix grave

Si une application d’accessibilité prend en charge plusieurs hébergements, la valeur du Registre profil doit inclure un attribut de type Accommodation pour chaque hébergement.

Détails du Registre de facilité d’accès

Pour inscrire votre application d’accessibilité, vous devez créer une clé pour votre application à l’emplacement de Registre suivant et la remplir avec des paires nom-valeur.

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\

Nommez la clé de Registre de votre application au format suivant :

« CompanyName_ProductName_v# »

Par exemple, « Contoso_Magnifier_v2.0 ».

Pour ajouter des valeurs de Registre, votre programme d’installation doit s’exécuter avec des privilèges élevés.

Hébergement sécurisé des postes de travail

La clé de Registre SecureDesktopAccommodation vous permet de spécifier la façon dont votre application d’accessibilité répond au bureau sécurisé. Par défaut, le Centre d’accès facile lance votre application sur le bureau sécurisé si elle s’exécute déjà sur le bureau normal ou si elle est configurée pour s’exécuter sur le bureau d’ouverture de session. À l’aide de la clé SecureDesktopAccommodation , vous pouvez :

• Spécifiez une autre version de votre application à utiliser sur le bureau sécurisé. Par exemple, vous pouvez avoir une autre version qui désactive les fonctionnalités non sécurisées ou qui est optimisée pour utiliser moins de mémoire et lancer plus rapidement.

  Pour spécifier l’autre version, définissez la clé SecureDesktopAccommodation sur le nom de la version alternative. Par exemple, si vous avez inscrit votre application à la clé Contoso_Screen Reader_v1.0, vous pouvez inscrire l’autre version à Contoso_Screen ReaderSecure_v1.0. Ensuite, définissez la clé SecureDesktopAccommodation de Contoso_Screen Reader_v1.0 sur « Contoso_Screen ReaderSecure_v1.0 ».

• Spécifiez une application d’accessibilité Microsoft à utiliser sur le bureau sécurisé à la place de votre application. Pour cette option, définissez SecureDesktopAccommodation sur le nom de l’application d’accessibilité Microsoft particulière : « osk », « loupepane » ou « Narrateur ».

• Spécifiez que votre application ne doit pas s’exécuter sur le bureau sécurisé, ni aucune autre application. Pour cette option, définissez SecureDesktopAccommodation sur « none » (recommander) ou le nom d’une application inexistante.

Si la clé de Registre SecureDesktopAccommodation pour votre application d’accessibilité spécifie une application d’accessibilité Microsoft à exécuter sur le bureau sécurisé à la place de votre application, Windows en avertit l’utilisateur lors de la transition vers le bureau sécurisé. Pour informer l’utilisateur, Windows affiche la chaîne spécifiée dans la clé de Registre Description de votre application. Par exemple, si l’application ScreenReader Deluxe 1.0 utilise Microsoft Narrateur sur le bureau sécurisé, elle inclut une chaîne description telle que « Le Narrateur Microsoft sera utilisé dans les bureaux verrouillés, d’ouverture de session et d’autres bureaux sécurisés à la place de ScreenReader Deluxe 1.0 ».

Si la clé SecureDesktopAccommodation de votre application est définie sur « none », utilisez la clé Description pour indiquer à l’utilisateur que votre application n’est pas disponible sur le bureau sécurisé et qu’aucune alternative n’est fournie.

Windows affiche le texte Description dans les emplacements appropriés dans le Centre d’accessibilité.

Exécution lors de l’installation et sur le bureau d’ouverture de session

Si vous ajoutez le nom de clé inscrite de votre application d’accessibilité à la chaîne à l’emplacement de Registre suivant, Windows lance votre application immédiatement après son installation. En outre, Windows exécute automatiquement votre application chaque fois que le bureau d’ouverture de session est actif.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\Accessibility\Configuration

La clé configuration est une chaîne délimitée par des virgules. Pour ajouter votre application, ajoutez une chaîne identique à la clé de Registre de votre application dans HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\.

Exécution dans un travail

Si la clé de Registre TerminateOnDesktopSwitch n’est pas présente ou n’est pas définie sur zéro, Windows exécute l’application dans le contexte d’un travail, mettant fin et redémarrant l’application à chaque transition de bureau. L’exécution dans un travail garantit qu’un seul instance de l’application est en cours d’exécution à un moment donné et libère l’application d’avoir à surveiller l’état du bureau. Les inconvénients de l’exécution dans un travail sont les suivants :

• L’application entraîne un coût de démarrage à chaque transition du bureau.
• L’application ne peut être démarrée que via le Centre d’accès facile.
• L’application doit enregistrer continuellement ses paramètres, car elle peut être arrêtée à tout moment par une transition de bureau.

Si la clé TerminateOnDesktopSwitch existe et est définie sur 0, Windows n’exécute pas l’application d’accessibilité dans un travail. Les avantages sont les suivants :

• Aucun coût de démarrage n’est associé aux transitions de bureau.
• L’application peut être démarrée en dehors du Centre de facilité d’accès.

Les inconvénients de ne pas s’exécuter dans un travail sont les suivants :

• Étant donné que l’application n’est pas redémarrée lors des transitions de bureau, elle doit détecter quand le bureau actuel est inactif et y répondre de manière appropriée. Par exemple, l’application doit abandonner le contrôle du matériel afin que la version de bureau sécurisée de l’application puisse l’utiliser, et l’application doit passer en mode veille pour éviter d’utiliser les ressources du processeur.
• Si l’application peut être démarrée via le menu Démarrer, Windows Explorer ou la ligne de commande, le Centre d’accès facile doit être informé. Pour plus d’informations, consultez Touche de logo Windows + U.
• Étant donné que plusieurs copies de l’application peuvent s’exécuter simultanément sur différents bureaux, l’application doit être écrite pour prendre en charge plusieurs copies en cours d’exécution.

Touche de logo Windows + U

Si votre application d’accessibilité est configurée pour s’exécuter dans un travail, le code de démarrage de votre application doit inclure un appel à la fonction IsProcessInJob pour déterminer si l’application démarre dans un travail. Si c’est le cas, l’application doit démarrer le Centre d’accès, puis quitter. L’exemple suivant montre comment appeler IsProcessInJob.

BOOL fAlreadyInJob;
BOOL fSuccess = IsProcessInJob(GetCurrentProcess(), NULL, &fAlreadyInJob); 

Si l’application d’accessibilité est configurée pour s’exécuter en dehors d’un travail, elle doit informer le Centre d’accès que l’application démarre et continue normalement.

Quelle que soit la façon dont l’application est configurée, si elle permet de quitter l’application, par exemple un bouton Fermer, l’application doit informer le Centre d’accès facilité qu’elle quitte.

Une application avertit le Centre d’accès en définissant une clé de Registre temporaire, puis en injectant la combinaison touche de logo Windows + touche U dans le flux d’entrée.

L’application doit créer la clé temporaire à l’emplacement suivant.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\AccessibilityTemp

La clé temporaire doit avoir le même nom que le nom de l’application inscrite, par exemple « Contoso_Screen Reader_v1.0 ». La valeur de la clé est un DWORD défini sur 0x0003 au démarrage ou 0x0002 lors de la sortie de l’application.

INPUT input[4] = {0};

input[0].type = INPUT_KEYBOARD;
input[0].ki.wVk = VK_LWIN;
input[0].ki.dwFlags = 0;

input[1].type = INPUT_KEYBOARD;
input[1].ki.wVk = 0x55; // U key
input[1].ki.dwFlags = 0;

input[2].type = INPUT_KEYBOARD;
input[2].ki.wVk = 0x55; // U key
input[2].ki.dwFlags = KEYEVENTF_KEYUP;

input[3].type = INPUT_KEYBOARD;
input[3].ki.wVk = VK_LWIN;
input[3].ki.dwFlags = KEYEVENTF_KEYUP;

SendInput(ARRAYSIZE(input), input, sizeof(input[0]));

Touche de logo Windows + Augmenter le volume

Lorsque l’utilisateur démarre votre application d’accessibilité en appuyant sur la combinaison touche de logo Windows + touche Augmenter le volume (par exemple, sur une tablette), le Centre d’accessibilité passe l’argument de ligne de commande suivant à l’application :

/hardwarebuttonlaunch

Votre application peut utiliser cet argument pour déterminer s’il faut démarrer normalement ou ajuster le comportement en conséquence.

Transfert des paramètres de bureau sécurisés

Si votre application d’accessibilité prend en charge le bureau sécurisé, vous pouvez utiliser le Registre pour copier les paramètres lors de la transition de l’application vers le bureau sécurisé. La copie des paramètres permet de rendre la transition vers le bureau sécurisé plus fluide pour l’utilisateur.

Pour copier les paramètres, définissez la clé de Registre CopySettingsToLockedDesktop de l’application sur 1 et stockez les paramètres à l’emplacement de Registre suivant.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\Accessibility\ATConfig\<AT Key Name>

Le Centre d’accès facile surveille cet emplacement du Registre pendant l’exécution de l’application. Lorsqu’une transition vers le bureau sécurisé se produit, le Centre d’ergonomie d’accès copie les paramètres au même emplacement dans la ruche HKCU du bureau sécurisé. L’application peut ensuite lire les paramètres et reprendre son état.

Votre application d’accessibilité doit écrire ses paramètres à intervalles réguliers ou chaque fois que les valeurs changent. L’écriture des paramètres sur la sortie de l’application ne fonctionnera pas. Si l’application s’exécute dans un travail, elle est arrêtée lors de la transition loin du bureau sécurisé, avant que le code de sortie ait la possibilité de s’exécuter. Si l’application ne s’exécute pas dans un travail, l’application n’est pas arrêtée lors de la transition loin du bureau sécurisé.

Attention

Étant donné que les clés de Registre décrites ici sont écrites en mode utilisateur, elles ne sont pas sécurisées. Si votre application d’accessibilité lit le contenu de ces clés, elle doit soigneusement case activée les données et les utiliser avec précaution. Plus précisément, votre application doit effectuer une case activée limites sur les valeurs DWORD, faire attention aux longueurs de chaînes, ne doit pas lire les noms de DLL de plug-in et ne doit pas exécuter les commandes trouvées dans les chaînes.

Exemples de Registre

L’exemple suivant montre les valeurs de Registre possibles pour un produit fictif appelé Contoso ScreenReader version 2.0, dont le nom localisé est stocké en tant que ressource.

Les valeurs de la table se trouvent sous la clé suivante :

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\Contoso_Screen Reader_v2.0

<HCIModel>
   <Accommodation type="low vision">
   <Accommodation type="severe vision">
   <Accommodation type="mild cognitive">
</HCIModel>

Si l’application fournit un lecteur d’écran et une loupe d’écran dans un seul exécutable, les valeurs du composant lecteur d’écran peuvent ressembler à ceci :

<HCIModel>
   <Accommodation type="low vision">
   <Accommodation type="severe vision">
   <Accommodation type="mild cognitive">
</HCIModel>

Les valeurs du composant loupe se trouveraient dans la clé suivante :

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Contosoibility\ATs\Contoso_Magnifier_v2.0

<HCIModel>
   <Accommodation type="mild vision">
</HCIModel>