Utilisation de l’API DISM
L’API de gestion et de maintenance des images de déploiement (DISM) vous permet de créer des solutions personnalisées sur la plateforme DISM. Vous pouvez utiliser l’API DISM pour installer, désinstaller, configurer et mettre à jour les fonctionnalités, packages et pilotes Windows dans une image Windows. DISM peut être utilisé pour gérer et traiter des images Windows au format de fichier image Windows (.wim) ou des fichiers de disque dur virtuel (.vhd, .vhdx).
Conditions requises
Vous devez installer le Kit d’évaluation et de déploiement Windows (Windows ADK) sur votre ordinateur de développement afin de créer des applications d’API DISM :
Vos solutions personnalisées sur la plateforme DISM sont développées à l’aide du SDK DISM. Il est installé lorsque le Windows ADK est installé. Pour plus d’informations sur les systèmes d’exploitation pris en charge, consultez la référence technique du Kit d’évaluation et de déploiement Windows (Windows ADK).
Lorsque vous exécutez des solutions personnalisées sur la plateforme DISM, vous devez vérifier que la version de l’architecture Windows ADK correspond à la version de l’architecture du système d’exploitation. Par exemple, une solution personnalisée développée pour les PC 32 bits s’exécute sur la version 32 bits de Windows.
Pour développer et exécuter correctement vos solutions personnalisées sur la plateforme DISM, vous devez vérifier que vous utilisez les fichiers binaires DISM à partir de Windows ADK :
Installez la dernière version de Windows ADK sur le PC qui exécutera la solution personnalisée.
Les fichiers binaires de vos solutions personnalisées doivent être enregistrés dans le même répertoire que les fichiers binaires DISM installés par le windows ADK. Par exemple, vos fichiers binaires de solutions personnalisées doivent se trouver dans c:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM.
Exécutez vos solutions personnalisées à partir de l’environnement Outils de déploiement et d’acquisition d’images afin que les variables d’environnement nécessaires soient configurées avant d’exécuter vos solutions.
Dans l’écran d’accueil, tapez déploiement. Cliquez avec le bouton droit de la souris sur Environnement de déploiement et d’outils de création d’images , puis sélectionnez Exécuter en tant qu’administrateur.
Note Si vous n’exécutez pas à partir de l’environnement Outils de déploiement et d’acquisition d’images, vous devez vérifier que la variable d’environnement PATH utilise l’emplacement des fichiers binaires DISM à partir de Windows ADK.
Vous aurez besoin d’un type de fichier d’image Windows pris en charge, .wim, .vhd ou .vhdx, ou d’une installation en ligne de Windows pour utiliser DISMAPI pour la maintenance et la gestion. Certaines opérations ne sont pas valides sur les images en ligne. Pour plus d’informations, consultez référence de l’API DISM.
Images cibles prises en charge
Le fichier image Windows que vous gérez sur votre ordinateur hôte peut être un fichier .wim, un fichier .vhd ou .vhdx, ou une installation en ligne de Windows. En outre, la maintenance inter-architecture est prise en charge. Vous pouvez traiter une image x64 à partir d’un système x86 ou d’un système x64. Vous pouvez traiter une image x86 à partir d’un système x64 ou d’un système x86.
Toutes les fonctions DISMAPI peuvent être effectuées sur Windows 8 et Windows Server 2012 images cibles. Pour voir si une fonction peut être exécutée sur d’autres images cibles, consultez la section Exigences de la rubrique de référence de fonction dans la référence de l’API DISM.
Meilleures pratiques
Gestion de la mémoire Certaines fonctions d’API DISM retournent des structures ou des tableaux de structures. Ces structures sont retournées à l’utilisateur en tant que pointeur vers un objet sur le tas. La mémoire du tas est allouée par l’API DISM. Le client doit appeler la fonction DismDelete pour s’assurer que cette mémoire est libérée.
Montage d’un disque dur virtuel avec l’outil DiskPart. Si possible, vous devez utiliser l’API DISM pour monter et démonter les images que vous souhaitez traiter dans l’infrastructure DISM. L’utilisation d’un autre outil, tel que l’outil DiskPart, pour monter et démonter l’image peut avoir des effets inattendus.
Chemins d'accès aux fichiers. Tous les chemins d’accès acceptés par les fonctions d’API DISM peuvent être relatifs ou absolus. Il est recommandé de limiter la longueur des chemins d’accès aux fichiers. Les chemins de fichiers qui sont trop longs ou dépassent la limite de longueur maximale pour Windows entraînent des échecs dans DISM.
Correspondance des appels pour ouvrir et fermer des sessions. Libérez toujours une session DISM à l’aide de la fonction DismCloseSession avant d’appeler la fonction DismShutdown. Vous pouvez également démonter l’image avec la fonction DismUnmountImage après avoir fermé la session et avant d’appeler la fonction DismShutdown.
Autres outils DISM
Pour plus d’informations sur la plateforme DISM et sur d’autres façons d’accéder à la fonctionnalité de maintenance et de gestion, consultez la référence technique DISM dans la référence technique du Kit d’évaluation et de déploiement Windows (Windows ADK). Vous pouvez également utiliser l’outil DISM.exe dans Windows ADK pour capturer une image sous la forme d’un fichier .wim.
Rubriques connexes
Création d’une application DISM