Función SetupDiDestroyDriverInfoList (setupapi.h)

  • Artículo

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)

Consulte también

SetupDiBuildDriverInfoList