SetupDiDestroyDriverInfoList

BOOLEAN
    SetupDiDestroyDriverInfoList(
        IN HDEVINFO  DeviceInfoSet,
        IN PSP_DEVINFO_DATA  DeviceInfoData,    /* optional */
        IN DWORD  DriverType
        );

SetupDiDestroyDriverInfoList destroys a driver information list.

Parameters

DeviceInfoSet

Supplies a handle to the device information set that contains the driver information list to destroy.

DeviceInfoData

Supplies a pointer to the SP_DEVINFO_DATA structure associated with the driver information list to destroy. If this parameter is not specified, the global class driver list is destroyed.

DriverType

Specifies what type of driver list to destroy. Must be one of the following values:

SPDIT_CLASSDRIVER

Destroy a list of class drivers.

SPDIT_COMPATDRIVER

Destroy a list of compatible drivers for the specified device. DeviceInfoData must be specified if this flag is set.

Return Value

The function returns TRUE if it is successful. Otherwise it returns FALSE and the logged error can be retrieved with a call to GetLastError.

Comments

If the currently selected driver is a member of the list being destroyed, the selection is reset.

If a class driver list is being destroyed, the DI_FLAGSEX_DIDINFOLIST and DI_DIDCLASS flags are reset for the corresponding device information set or device information element. The DI_MULTMFGS flags is also reset.

If a compatible driver list is being destroyed, the DI_FLAGSEX_DIDCOMPATINFO and DI_DIDCOMPAT flags are reset for the corresponding device information element.

See Also

SetupDiBuildDriverInfoList