Función SetupDiDestroyDriverInfoList (setupapi.h)
La función SetupDiDestroyDriverInfoList elimina una lista de controladores.
Sintaxis
WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType
);
Parámetros
[in] DeviceInfoSet
Identificador de un conjunto de información de dispositivo que contiene la lista de controladores que se va a eliminar.
[in, optional] DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y se puede establecer en NULL. Si se especifica este parámetro, SetupDiDestroyDriverInfoList elimina la lista de controladores del dispositivo especificado. Si este parámetro es NULL, SetupDiDestroyDriverInfoList elimina la lista global de controladores de clase asociada a DeviceInfoSet.
[in] DriverType
El tipo de lista de controladores que se va a eliminar, que debe ser uno de los siguientes valores:
SPDIT_CLASSDRIVER
Elimina una lista de controladores de clase. Si DeviceInfoData es NULL, se debe especificar este tipo de lista de controladores.
SPDIT_COMPATDRIVER
Elimine una lista de controladores compatibles para el dispositivo especificado. Se debe especificar DeviceInfoData si se especifica este tipo de lista de controladores.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
Si el controlador seleccionado actualmente es miembro de la lista que se va a eliminar, se restablece la selección.
Si se elimina una lista de controladores de clase, las marcas DI_FLAGSEX_DIDINFOLIST y DI_DIDCLASS se restablecen para el conjunto de información del dispositivo o el elemento de información del dispositivo correspondiente. También se restablecen las marcas de DI_MULTMFGS.
Si se destruye una lista de controladores compatible, se restablecen las marcas de DI_FLAGSEX_DIDCOMPATINFO y DI_DIDCOMPAT correspondientes para el elemento de información del dispositivo correspondiente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |
| Conjunto de API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introducido en Windows 10, versión 10.0.14393) |