Fonction DismAddDriver
Ajoute un pilote tiers (.inf) à une image Windows hors connexion.
Syntaxe
HRESULT WINAPI DismAddDriver(
_In_ DismSession Session,
_In_ PCWSTR DriverPath,
_In_ BOOL ForceUnsigned
);
Paramètres
Session [entrée]
Une DismSession valide. La DismSession doit être associée à une image. Vous pouvez associer une session à une image à l’aide de la fonction DismOpenSession .
DriverPath [in]
Chemin d’accès relatif ou absolu au fichier .inf du pilote.
ForceUnsigned [in]
Valeur booléenne qui spécifie s’il faut accepter des pilotes non signés pour une image x64. Les pilotes non signés sont automatiquement ajoutés à une image x86.
Valeur | Description |
---|---|
TRUE | Ajoutez des pilotes non signés à une image x64. |
FALSE | N’ajoutez pas de pilotes non signés à une image x64. |
Valeur retournée
Retourne S_OK
en cas de réussite.
Exemples
Dans cet exemple, le pilote ajouté se trouve sur l’ordinateur de technicien dans le dossier C:\drivers\. Le pilote a le nom de fichier usb.inf sur l’ordinateur de technicien, mais est renommé en « OEM1.inf » ou « OEM2.inf » dans l’image cible. La numérotation des fichiers OEMx.inf dépend du nombre de pilotes ajoutés. Le nouveau nom, par exemple OEM1.inf, est retourné dans la structure DismDriverPackage lorsque vous appelez DismGetDrivers. Vous devez utiliser le nouveau nom, OEM1.inf, pour spécifier le DriverPath lorsque vous utilisez DismGetDriverInfo.
HRESULT hr = S_OK;
hr = DismAddDriver(Session, L"C:\\Drivers\\usb.inf", FALSE);
Spécifications
Condition requise | Description |
---|---|
Plateformes hôtes prises en charge | L’API DISM peut être utilisée sur n’importe quel système d’exploitation pris en charge par le Kit de déploiement et d’évaluation Windows (Windows ADK). Pour plus d’informations, consultez les Informations de référence technique Windows ADK. |
Plateformes d’images prises en charge | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, environnement de préinstallation Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
En-tête | DismAPI.h |
Bibliothèque | DismAPI.lib |
DLL | DismAPI.dll |