SetupDiDestroyDriverInfoList-Funktion (setupapi.h)

  • Artikel

Die SetupDiDestroyDriverInfoList-Funktion löscht eine Treiberliste.

Syntax

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

Parameter

[in] DeviceInfoSet

Ein Handle für einen Geräteinformationssatz , der die zu löschende Treiberliste enthält.

[in, optional] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt. Dieser Parameter ist optional und kann auf NULL festgelegt werden. Wenn dieser Parameter angegeben ist, löscht SetupDiDestroyDriverInfoList die Treiberliste für das angegebene Gerät. Wenn dieser Parameter NULL ist, löscht SetupDiDestroyDriverInforInfoList die globale Klassentreiberliste, die DeviceInfoSet zugeordnet ist.

[in] DriverType

Der Typ der zu löschenden Treiberliste, die einer der folgenden Werte sein muss:

SPDIT_CLASSDRIVER

Löschen Sie eine Liste von Klassentreibern. Wenn DeviceInfoDataNULL ist, muss dieser Treiberlistentyp angegeben werden.

SPDIT_COMPATDRIVER

Löschen Sie eine Liste mit kompatiblen Treibern für das angegebene Gerät. DeviceInfoData muss angegeben werden, wenn dieser Treiberlistentyp angegeben wird.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.

Hinweise

Wenn der aktuell ausgewählte Treiber Mitglied der liste ist, die gelöscht wird, wird die Auswahl zurückgesetzt.

Wenn eine Klassentreiberliste gelöscht wird, werden die flags DI_FLAGSEX_DIDINFOLIST und DI_DIDCLASS für den entsprechenden Geräteinformationssatz oder das entsprechende Geräteinformationselement zurückgesetzt. Die DI_MULTMFGS-Flags werden ebenfalls zurückgesetzt.

Wenn eine kompatible Treiberliste zerstört wird, werden die flags DI_FLAGSEX_DIDCOMPATINFO und DI_DIDCOMPAT für das entsprechende Geräteinformationselement zurückgesetzt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek Setupapi.lib
DLL Setupapi.dll
APIs ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

SetupDiBuildDriverInfoList