SetupDiDestroyDriverInfoList, fonction (setupapi.h)

La fonction SetupDiDestroyDriverInfoList supprime une liste de pilotes.

Syntaxe

WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
  [in]           HDEVINFO         DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA DeviceInfoData,
  [in]           DWORD            DriverType
);

Paramètres

[in] DeviceInfoSet

Handle d’un jeu d’informations de périphérique qui contient la liste des pilotes à supprimer.

[in, optional] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être défini sur NULL. Si ce paramètre est spécifié, SetupDiDestroyDriverInfoList supprime la liste des pilotes pour l’appareil spécifié. Si ce paramètre a la valeur NULL, SetupDiDestroyDriverInfoList supprime la liste des pilotes de classe globale associée à DeviceInfoSet.

[in] DriverType

Type de liste de pilotes à supprimer, qui doit être l’une des valeurs suivantes :

SPDIT_CLASSDRIVER

Supprimez une liste de pilotes de classe. Si DeviceInfoData a la valeur NULL, ce type de liste de pilotes doit être spécifié.

SPDIT_COMPATDRIVER

Supprimez la liste des pilotes compatibles pour l’appareil spécifié. DeviceInfoData doit être spécifié si ce type de liste de pilotes est spécifié.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

Si le pilote actuellement sélectionné est membre de la liste en cours de suppression, la sélection est réinitialisée.

Si une liste de pilotes de classe est en cours de suppression, les indicateurs DI_FLAGSEX_DIDINFOLIST et DI_DIDCLASS sont réinitialisés pour l’ensemble d’informations ou l’élément d’informations sur le périphérique correspondant. Les indicateurs DI_MULTMFGS sont également réinitialisés.

Si une liste de pilotes compatibles est en cours de destruction, les indicateurs DI_FLAGSEX_DIDCOMPATINFO et DI_DIDCOMPAT sont réinitialisés pour l’élément d’informations de périphérique correspondant.

Configuration requise

Voir aussi

SetupDiBuildDriverInfoList