Partager via


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