SetupDiInstallDeviceInterfaces 함수(setupapi.h)

  • 아티클

SetupDiInstallDeviceInterfaces 함수는 DIF_INSTALLINTERFACES 설치 요청에 대한 기본 처리기입니다.

구문

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

매개 변수

[in] DeviceInfoSet

인터페이스를 설치할 디바이스 를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합에 대한 포인터입니다. 디바이스 정보 집합에는 로컬 시스템에 대한 요소만 포함되어야 합니다.

[in] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.

반환 값

SetupDiInstallDeviceInterfaces는 함수가 오류 없이 완료된 경우 TRUE 를 반환합니다. 함수가 오류로 완료되면 FALSE 가 반환되고 GetLastError를 호출하여 오류에 대한 오류 코드를 검색할 수 있습니다.

설명

SetupDiInstallDeviceInterfaces는DDInstall의 각 AddInterface 항목을 처리합니다. 디바이스 INF 파일의 인터페이스 섹션 및 는 SetupDiCreateDeviceInterface를 호출하여 각 인터페이스를 만듭니다.

SetupDiInstallDeviceInterfaces의 호출자는 Administrators 그룹의 구성원이어야 합니다.

참고클래스 설치 관리자 만 SetupDiInstallDeviceInterfaces 를 호출해야 하며, SetupDiInstallDeviceInterfaces 가 기본 디바이스 인터페이스 설치 작업을 완료한 후에는 클래스 설치 관리자가 디바이스 인터페이스 설치 작업을 수행해야 하는 경우에만 호출해야 합니다. 이러한 경우 클래스 설치 관리자는 설치 관리자가 DIF_INSTALLINTERFACES 요청을 처리할 때 SetupDiInstallDeviceInterfaces 를 직접 호출해야 합니다. 기본 처리기를 호출하는 방법에 대한 자세한 내용은 기본 DIF 코드 처리기 호출을 참조하세요.
 
INF 파일 형식에 대한 자세한 내용은 INF 파일 섹션 및 지시문을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib
DLL Setupapi.dll

추가 정보

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface