Funzione SetupDiDestroyDriverInfoList (setupapi.h)
La funzione SetupDiDestroyDriverInfoList elimina un elenco di driver.
Sintassi
WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType
);
Parametri
[in] DeviceInfoSet
Handle per un set di informazioni sul dispositivo che contiene l'elenco di driver da eliminare.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere impostato su NULL. Se questo parametro viene specificato, SetupDiDestroyDriverInfoList elimina l'elenco di driver per il dispositivo specificato. Se questo parametro è NULL, SetupDiDestroyDriverInfoList elimina l'elenco di driver di classe globale associato a DeviceInfoSet.
[in] DriverType
Tipo di elenco di driver da eliminare, che deve essere uno dei valori seguenti:
SPDIT_CLASSDRIVER
Eliminare un elenco di driver di classe. Se DeviceInfoData è NULL, è necessario specificare questo tipo di elenco di driver.
SPDIT_COMPATDRIVER
Eliminare un elenco di driver compatibili per il dispositivo specificato. DeviceInfoData deve essere specificato se è specificato questo tipo di elenco di driver.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Se il driver attualmente selezionato è un membro dell'elenco da eliminare, la selezione viene reimpostata.
Se viene eliminato un elenco di driver di classe, i flag DI_FLAGSEX_DIDINFOLIST e DI_DIDCLASS vengono reimpostati per il set di informazioni sul dispositivo o l'elemento informazioni sul dispositivo corrispondente. Vengono reimpostati anche i flag DI_MULTMFGS.
Se viene eliminato definitivamente un elenco di driver compatibili, i flag DI_FLAGSEX_DIDCOMPATINFO e DI_DIDCOMPAT vengono reimpostati per l'elemento informazioni sul dispositivo corrispondente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |
| Set di API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393) |