INF DefaultInstall 섹션
참고
범용 드라이버 패키지를 빌드하는 경우 이 섹션은 아키텍처 장식이 있는 경우에만 유효합니다(예[DefaultInstall.NTAMD64]: ).
참고
INF에서 DefaultInstall 및 Manufacturer 섹션을 모두 사용하면 유니버설 INF 유효성 검사 오류가 발생하고 일관되지 않은 설치 동작이 발생할 수 있습니다. 유니버설 INF 파일 사용을 참조하세요.
INF 파일 이름을 선택하고 길게 누르거나 마우스 오른쪽 단추로 클릭한 후 사용자가 "설치" 메뉴 항목을 선택하는 경우 INF 파일의 DefaultInstall 섹션에 액세스합니다. Windows 10 버전 1903 이상 버전의 Windows에서는 기본 드라이버의 요구 사항을 충족하는 경우 DefaultInstall이 있는 INF를 여러 드라이버 패키지 API에서 사용할 수 있습니다.
[DefaultInstall] |
[DefaultInstall.nt] |
[DefaultInstall.ntx86] |
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...
항목
모든 유효한 항목이 유니버설 INF에서 지원되는 것은 아닙니다. 다음은 범용 INF에서 유효한 지시문과 그렇지 않은 지시문을 나열합니다.
유니버설 INF에서 지원됨
CopyFiles=@filename | file-list-section[,file-list-section] ...
이 선택적 지시문은 원본 매체에서 대상으로 복사할 명명된 파일 하나를 지정하거나 원본 미디어에서 대상으로 전송할 파일을 지정하는 하나 이상의 INF 작성기 정의 섹션을 참조합니다.
INF의 DestinationDirs 섹션에 있는 DefaultDestDir 항목은 복사할 단일 파일의 대상을 지정합니다. SourceDisksNames 및 SourceDisksFiles 섹션 또는 이 INF 버전 섹션의 LayoutFile 항목에 지정된 추가 INF는 드라이버 파일의 배포 미디어의 위치를 제공합니다.
자세한 내용은 INF CopyFiles 지시문을 참조하세요.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP 이상 버전의 Windows.) 이 지시문은 지정된 INF 파일을 대상 시스템에 복사합니다.
자세한 내용은 INF CopyINF 지시문을 참조하세요.
AddReg=add-registry-section[,add-registry-section]...
이 지시문은 초기 값 항목이 있는 새 하위 키가 레지스트리에 기록되도록 지정되거나 기존 키의 값 항목이 수정되는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF AddReg 지시문을 참조하세요.
Include=filename1.inf[,filename2.inf]...
이 선택적 항목은 이 디바이스 및/또는 드라이버를 설치하는 데 필요한 섹션이 포함된 하나 이상의 추가 시스템 제공 INF 파일을 지정합니다. 이 항목을 지정하면 일반적으로 요구 항목도 마찬가지입니다.
예를 들어 시스템의 커널 스트리밍 지원에 의존하는 디바이스 드라이버에 대한 시스템 INF 파일은 다음과 같이 이 항목을 지정합니다.
Include= ks.inf,kscaptur.inf,ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
이 선택적 항목은 이 디바이스를 설치하는 동안 처리해야 하는 시스템 제공 INF 파일 내의 섹션을 지정합니다. 일반적으로 이러한 명명된 섹션은 DDInstall(또는 DDInstall)입니다.xxx) 포함 항목에 나열된 INF 파일 중 하나 내의 섹션입니다. 그러나 이러한 DDInstall 또는 DDInstall 내에서 참조되는 섹션일 수 있습니다.포함된 INF의 xxx 섹션입니다.
예를 들어 앞의 Include 항목이 있는 디바이스 드라이버에 대한 INF 파일은 다음과 같이 이 항목을 지정합니다.
Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation
유니버설 INF에서 지원되지 않음
Delfiles=file-list-section[,file-list-section]...
이 지시문은 삭제할 대상의 파일을 나열하는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF DelFiles 지시문을 참조하세요.
Renfiles=file-list-section[,file-list-section]...
이 지시문은 디바이스 관련 원본 파일을 대상 컴퓨터에 복사하기 전에 대상에서 이름을 바꿀 파일을 나열하는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF RenFiles 지시문을 참조하세요.
DelReg=del-registry-section[,del-registry-section]...
이 지시문은 디바이스를 설치하는 동안 레지스트리에서 키 및/또는 값 항목을 제거하도록 지정된 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF DelReg 지시문을 참조하세요.
BitReg=bit-registry-section[,bit-registry-section]...
이 지시문은 REG_BINARY 형식의 기존 레지스트리 값 항목이 수정되는 하나 이상의 INF 기록기 정의 섹션을 참조합니다. 자세한 내용은 INF AddReg 지시문을 참조하세요.
자세한 내용은 INF BitReg 지시문을 참조하세요.
ProfileItems=profile-items-section[,profile-items-section]...
이 지시문은 시작 메뉴에 추가하거나 제거할 항목을 설명하는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF ProfileItems 지시문을 참조하세요.
UpdateInis=update-ini-section[,update-ini-section]...
이 드물게 사용되는 지시문은 하나 이상의 INF 기록기 정의 섹션을 참조하며, 이러한 섹션 내의 특정 섹션 또는 줄을 설치하는 동안 동일한 이름의 대상 INI 파일로 읽을 원본 INI 파일을 지정합니다. 필요에 따라 동일한 이름의 지정된 원본 INI 파일에서 대상의 기존 INI 파일에 대한 줄 단위 수정을 update-ini 섹션에서 지정할 수 있습니다.
자세한 내용은 INF UpdateInis 지시문을 참조하세요.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
이 드물게 사용되는 지시문은 디바이스별 INI 파일의 줄 내에서 수정이 지정된 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF UpdateIniFields 지시문을 참조하세요.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
이 드물게 사용되는 지시문은 원본 미디어에 제공된 디바이스별 INI 파일의 섹션 또는 줄을 레지스트리로 이동하는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.
자세한 내용은 INF Ini2Reg 지시문을 참조하세요.
RegisterDlls=register-dll-section[,register-dll-section]...
이 지시문은 OLE 컨트롤이고 자체 등록이 필요한 파일을 지정하는 데 사용되는 하나 이상의 INF 섹션을 참조합니다.
자세한 내용은 INF RegisterDlls 지시문을 참조하세요.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
이 지시문은 OLE 컨트롤이고 자체 등록 취소(자체 제거)가 필요한 파일을 지정하는 데 사용되는 하나 이상의 INF 섹션을 참조합니다.
자세한 내용은 INF UnregisterDlls 지시문을 참조하세요.
설명
DefaultInstall 섹션은 디바이스 설치에 사용하면 안 됩니다. 디바이스 노드(devnode)와 연결되지 않은 클래스 필터 드라이버, 파일 시스템 필터 및 커널 드라이버 서비스의 설치에만 DefaultInstall 섹션을 사용합니다.
Windows 10 버전 1903 이상 버전의 Windows에서 DefaultInstall을 사용하는 경우 INF 파일이 기본 드라이버의 요구 사항을 충족하는 것이 좋습니다.
참고
드라이버 패키지가 디지털 서명되는 경우 Manufacturer 섹션이 있는 드라이버 패키지의 INF 파일에 INF DefaultInstall 섹션이 포함되어서는 안 됩니다. 드라이버 패키지 서명에 대한 자세한 내용은 드라이버 서명을 참조하세요.
디바이스 설치 애플리케이션에서 DefaultInstall 섹션을 설치하려면 InstallHinfSection에 대한 다음 호출을 사용합니다.
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
시스템 정의 .nt, .ntx86, .ntia64, .ntamd64, .ntarm 및 .ntarm64 확장을 사용하는 방법에 대한 자세한 내용은 여러 플랫폼 및 운영 체제용 INF 파일 만들기를 참조하세요.
예제
다음 예제에서는 일반적인 DefaultInstall 섹션을 보여줍니다.
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries