SetupDiDestroyDriverInfoList 함수(setupapi.h)

SetupDiDestroyDriverInfoList 함수는 드라이버 목록을 삭제합니다.

구문

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

매개 변수

[in] DeviceInfoSet

삭제할 드라이버 목록이 포함된 디바이스 정보 집합 에 대한 핸들입니다.

[in, optional] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL로 설정할 수 있습니다. 이 매개 변수를 지정하면 SetupDiDestroyDriverInfoList 가 지정된 디바이스에 대한 드라이버 목록을 삭제합니다. 이 매개 변수가 NULL이면 SetupDiDestroyDriverInfoList 는 DeviceInfoSet과 연결된 전역 클래스 드라이버 목록을 삭제합니다.

[in] DriverType

삭제할 드라이버 목록의 형식이며 다음 값 중 하나여야 합니다.

SPDIT_CLASSDRIVER

클래스 드라이버 목록을 삭제합니다. DeviceInfoData가 NULL인 경우 이 드라이버 목록 유형을 지정해야 합니다.

SPDIT_COMPATDRIVER

지정된 디바이스에 대해 호환되는 드라이버 목록을 삭제합니다. 이 드라이버 목록 형식이 지정된 경우 DeviceInfoData를 지정해야 합니다.

반환 값

함수가 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.

설명

현재 선택한 드라이버가 삭제되는 목록의 멤버인 경우 선택 영역이 다시 설정됩니다.

클래스 드라이버 목록이 삭제되는 경우 해당 디바이스 정보 집합 또는 디바이스 정보 요소에 대해 DI_FLAGSEX_DIDINFOLIST 및 DI_DIDCLASS 플래그가 다시 설정됩니다. DI_MULTMFGS 플래그도 다시 설정됩니다.

호환되는 드라이버 목록이 제거되는 경우 해당 디바이스 정보 요소에 대해 DI_FLAGSEX_DIDCOMPATINFO 및 DI_DIDCOMPAT 플래그가 다시 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib
DLL	Setupapi.dll
API 세트	ext-ms-win-setupapi-classinstallers-l1-1-2(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

SetupDiBuildDriverInfoList