Função SetupDiDestroyDriverInfoList (setupapi.h)

A função SetupDiDestroyDriverInfoList exclui uma lista de drivers.

Sintaxe

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

Parâmetros

[in] DeviceInfoSet

Um identificador para um conjunto de informações do dispositivo que contém a lista de driver a ser excluída.

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet. Esse parâmetro é opcional e pode ser definido como NULL. Se esse parâmetro for especificado, SetupDiDestroyDriverInfoList excluirá a lista de driver do dispositivo especificado. Se esse parâmetro for NULL, SetupDiDestroyDriverInfoList excluirá a lista de drivers de classe global associada a DeviceInfoSet.

[in] DriverType

O tipo de lista de driver a ser excluído, que deve ser um dos seguintes valores:

SPDIT_CLASSDRIVER

Exclua uma lista de drivers de classe. Se DeviceInfoData for NULL, esse tipo de lista de driver deverá ser especificado.

SPDIT_COMPATDRIVER

Exclua uma lista de drivers compatíveis para o dispositivo especificado. DeviceInfoData deverá ser especificado se esse tipo de lista de driver for especificado.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.

Comentários

Se o driver selecionado no momento for um membro da lista que está sendo excluída, a seleção será redefinida.

Se uma lista de driver de classe estiver sendo excluída, os sinalizadores DI_FLAGSEX_DIDINFOLIST e DI_DIDCLASS serão redefinidos para o conjunto de informações do dispositivo correspondente ou o elemento de informações do dispositivo. Os sinalizadores de DI_MULTMFGS também são redefinidos.

Se uma lista de driver compatível estiver sendo destruída, os sinalizadores DI_FLAGSEX_DIDCOMPATINFO e DI_DIDCOMPAT serão redefinidos para o elemento de informações do dispositivo correspondente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib
DLL Setupapi.dll
Conjunto de APIs ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393)

Confira também

SetupDiBuildDriverInfoList