Condividi tramite


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)

Vedi anche

SetupDiBuildDriverInfoList