INF DDInstall 섹션

아티클
06/14/2023

각 모델별 DDInstall 섹션에는 선택적 DriverVer 지시문과 INF 파일에서 명명된 추가 섹션을 참조하는 하나 이상의 지시문이 포함되어 있으며, 가장 자주 지정된 INF 지시문인 CopyFiles 및 AddReg가 먼저 나열되어 있습니다.

이러한 지시문에서 참조하는 섹션에는 드라이버 파일을 설치하고 레지스트리에 디바이스별 및/또는 드라이버 관련 정보를 쓰기 위한 지침이 포함되어 있습니다.

[install-section-name] | 
[install-section-name.nt] | 
[install-section-name.ntx86] | 
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)

[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[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]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[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]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]

항목

모든 유효한 항목이 유니버설 INF에서 지원되지는 않습니다. 다음은 범용 INF에서 유효한 지시문과 그렇지 않은 지시문을 나열합니다.

유니버설 INF에서 지원됨

DriverVer=mm/dd/yyyy[,x.y.v.z]
이 선택적 항목은 드라이버 패키지에 대한 버전 정보를 지정합니다.

이 항목을 지정하는 방법에 대한 자세한 내용은 INF DriverVer 지시문을 참조하세요.

CopyFiles=@filename | file-list-section[,file-list-section] ...
이 지시문은 원본 미디어에서 대상으로 복사할 명명된 파일 하나를 지정하거나 원본 미디어의 디바이스 관련 파일이 대상으로 전송되도록 지정된 하나 이상의 INF 기록기 정의 섹션을 참조합니다. CopyFiles 지시문은 선택 사항이지만 대부분의 DDInstall 섹션에 있습니다.

INF의 DestinationDirs 섹션에 있는 DefaultDestDir 항목은 복사할 단일 파일의 대상을 지정합니다. SourceDisksNames 및 SourceDisksFiles 섹션 또는 이 INF 버전 섹션의 LayoutFile 항목에 지정된 추가 INF는 드라이버 파일의 배포 미디어에서 위치를 제공합니다.

자세한 내용은 INF CopyFiles 지시문을 참조하세요.

CopyINF=filename1.inf[,filename2.inf]...
(Windows XP 이상) 이 지시문을 사용하면 지정된 INF 파일이 대상 시스템에 복사됩니다.

자세한 내용은 INF CopyINF 지시문을 참조하세요.

AddReg=add-registry-section[,add-registry-section]...
이 지시문은 초기 값 항목이 있는 새 하위 키가 레지스트리에 기록되도록 지정되거나 기존 키의 값 항목이 수정되는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.

이러한 추가 레지스트리 섹션의 HKR 사양은 설치 중인 디바이스의 "소프트웨어 키" 레지스트리 경로를 지정합니다.

자세한 내용은 INF AddReg 지시문을 참조하세요.

AddProperty=add-property-section[,add-property-section]...
(Windows Vista 이상) 디바이스 instance 대해 설정된 디바이스 속성을 수정하는 하나 이상의 INF 파일 섹션을 참조합니다. INF AddProperty 지시문을 사용하여 Windows Vista 이상 버전의 Windows 운영 체제에 새로운 디바이스 instance 속성을 설정해야 합니다.

이전에 Windows Server 2003, Windows XP 또는 Windows 2000에서 도입되었으며 해당 레지스트리 항목 값이 있는 디바이스 instance 속성의 경우 INF AddReg 지시문을 계속 사용하여 디바이스 instance 속성을 설정해야 합니다. 이러한 지침은 시스템 정의 속성 및 사용자 지정 속성에 적용됩니다. AddProperty 지시문을 사용하는 방법에 대한 자세한 내용은 INF AddProperty 지시문 및 INF DelProperty 지시문 사용을 참조하세요.

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

FeatureScore=featurescore

경고

FeatureScore 지시문은 [DDInstall] 섹션에서 직접 지정한 경우에만 처리됩니다.

(Windows Vista 이상) 이 지시문은 드라이버가 지원하는 기능을 기반으로 하는 드라이버에 대한 추가 순위 기준을 제공합니다. 예를 들어 클래스별 조건에 따라 드라이버를 구분하는 디바이스 설정 클래스 에 대해 기능 점수를 정의할 수 있습니다.

드라이버의 순위를 지정하는 방법에 대한 자세한 내용은 Windows 순위 드라이버 방법(Windows Vista 이상)을 참조하세요.

이 지시문에 대한 자세한 내용은 INF FeatureScore 지시문을 참조하세요.

참고

DDInstall 섹션에는 여러 FeatureScore 항목이 포함될 수 있지만 섹션에 대한 첫 번째 항목만 처리됩니다.

ExcludeID=device-identification-string[,device-identification-string]...

경고

ExcludeID 지시문은 [DDInstall] 섹션에서 직접 지정한 경우에만 처리됩니다.

(Windows XP 이상) 이 지시문은 하나 이상의 디바이스 ID 문자열( 하드웨어 ID 또는 호환 ID)을 지정합니다. DDInstall 섹션에서는 나열된 하드웨어 ID 또는 호환 ID와 일치하는 디바이스 ID가 있는 디바이스를 설치하지 않습니다.

Reboot
이 지시문은 설치가 완료된 후 호출자에게 시스템을 다시 부팅하라는 메시지가 표시되어야 했음을 나타냅니다.

자세한 내용은 INF Reboot 지시문을 참조하세요.

유니버설 INF에서 지원되지 않음

Delfiles=file-list-section[,file-list-section]...
이 지시문은 삭제할 대상의 파일을 나열하는 하나 이상의 INF-기록기 정의 섹션을 참조합니다.

자세한 내용은 INF DelFiles 지시문을 참조하세요.

Renfiles=file-list-section[,file-list-section]...
이 지시문은 디바이스 관련 원본 파일을 대상 컴퓨터에 복사하기 전에 대상에서 이름을 바꿀 파일을 나열하는 하나 이상의 INF-writer 정의 섹션을 참조합니다.

자세한 내용은 INF RenFiles 지시문을 참조하세요.

DelReg=del-registry-section[,del-registry-section]...
이 지시문은 디바이스를 설치하는 동안 레지스트리에서 키 및/또는 값 항목이 제거되도록 지정된 하나 이상의 INF 기록기 정의 섹션을 참조합니다.

일반적으로 이 지시문은 INF가 이 디바이스의 이전 설치에서 이전 레지스트리 항목을 클린 때 업그레이드를 처리하는 데 사용됩니다.

이러한 삭제 레지스트리 섹션의 HKR 사양은 설치 중인 디바이스의 "소프트웨어 키" 레지스트리 경로를 지정합니다.

자세한 내용은 INF DelReg 지시문을 참조하세요.

DelProperty=del-property-section[,del-property-section]...
(Windows Vista 이상) 디바이스 instance 대해 설정된 디바이스 속성을 삭제하는 하나 이상의 INF 파일 섹션을 참조합니다. INF DelProperty 지시문을 사용하여 Windows Vista 이상 버전의 Windows에 새로 추가된 디바이스 instance 속성을 삭제해야 합니다.

이전에 Windows Server 2003, Windows XP 또는 Windows 2000에서 도입되었으며 해당 레지스트리 항목 값이 있는 디바이스 instance 속성의 경우 INF DelReg 지시문을 계속 사용하여 디바이스 instance 속성을 삭제해야 합니다. 이러한 지침은 시스템 정의 속성 및 사용자 지정 속성에 적용됩니다. DelProperty 지시문을 사용하는 방법에 대한 자세한 내용은 INF AddProperty 지시문 및 INF DelProperty 지시문 사용을 참조하세요.

BitReg=bit-registry-section[,bit-registry-section]...
이 지시문은 REG_BINARY 형식의 기존 레지스트리 값 항목이 수정되는 하나 이상의 INF 기록기 정의 섹션을 참조합니다.

이러한 비트 레지스트리 섹션의 HKR 사양은 설치 중인 디바이스의 "소프트웨어 키" 레지스트리 경로를 지정합니다.

자세한 내용은 INF BitReg 지시문을 참조하세요.

LogConfig=log-config-section[,log-config-section]...
이 지시문은 루트 열거형 디바이스 또는 수동으로 설치된 디바이스에 대해 INF 내에서 하나 이상의 INF 기록기 정의 섹션을 참조합니다. 이러한 명명된 섹션에서 이러한 "검색됨" 또는 수동으로 설치된 디바이스에 대한 INF는 디바이스가 작동해야 하는 버스 상대 하드웨어 리소스의 논리적 구성을 하나 이상 지정합니다. 소프트웨어 구성이 불가능한 수동으로 설치된 디바이스에 대한 INF에도 DDInstall이 있어야 합니다. FactDef 섹션.

LogConfig 지시문은 PnP(플러그 앤 플레이) 디바이스를 설치하는 데 사용되지 않습니다. 그러나 INF DDInstall.LogConfigOverride 섹션 을 사용하여 PnP 디바이스에 대한 재정의 구성을 제공할 수 있습니다.

이 지시문은 모든 상위 수준(비디바이스) 드라이버 및 구성 요소와 관련이 없습니다.

자세한 내용은 INF LogConfig 지시문을 참조하세요.

ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 이상 버전의 Windows) 이 거의 사용되지 않는 지시문은 시작 메뉴에 추가하거나 제거할 항목을 설명하는 하나 이상의 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 지시문을 참조하세요.

설명

WDK(Windows 드라이버 키트) 설명서 전체에서 DDInstall 이라는 용어는 플랫폼 확장이 있거나 없는 install-section-name을 참조하는 데 사용됩니다. 따라서 "DDInstall section"은 "INF 내에서 명명된 섹션을 의미하며 형식은 [install-section-name] 또는 [install-section-name.ntxxx]"입니다. DDInstall 섹션의 이름을 만들 때 [WDMPNPB003_Device] 또는 [GPR400]과 같은 디바이스별 접두사를 포함해야 합니다. Install.NT].

각 DDInstall 섹션은 INF 파일의 제조업체별 INF 모델 섹션 에 있는 디바이스/모델별 항목에서 참조되어야 합니다.

원본 미디어에서 전송할 연결된 파일이 없는 디바이스를 제외하고 다른 운영 체제 플랫폼에 WDM 드라이버를 설치하는 INF 파일에는 다음 DDInstall 섹션 중 하나 이상이 있어야 합니다.

x86 기반 플랫폼과 관련된 디바이스/드라이버 설치에 대한 항목을 지정하는 install-section-name.ntx86 섹션입니다.
Itanium 기반 플랫폼과 관련된 디바이스/드라이버 설치에 대한 항목을 지정하는 install-section-name.ntia64 섹션입니다.
x64 기반 플랫폼과 관련된 디바이스/드라이버 설치에 대한 항목을 지정하는 install-section-name.ntamd64 섹션입니다.
Arm 기반 플랫폼과 관련된 디바이스/드라이버 설치에 대한 항목을 지정하는 install-section-name.ntarm 섹션입니다.
Arm64 기반 플랫폼과 관련된 디바이스/드라이버 설치에 대한 항목을 지정하는 install-section-name.ntarm64 섹션입니다.
특정 하드웨어 플랫폼과 관련이 없는 디바이스/드라이버 설치에 대한 항목을 지정하는 install-section-name 또는 install-section-name.nt 섹션입니다.

시스템 정의 .nt, .ntx86, .ntia64, .ntamd64, .ntarm 및 .ntarm64 확장을 사용하는 방법에 대한 자세한 내용은 여러 플랫폼 및 운영 체제에 대한 INF 파일 만들기를 참조하세요.

Windows 2000부터 드라이버를 설치하는 INF 파일에는 드라이버 서비스 정보를 지정하는 DDInstall.Services 섹션이 있어야 합니다.

DDInstall 섹션의 각 지시문은 둘 이상의 섹션 이름을 참조할 수 있습니다. 그러나 명명된 각 추가 섹션은 쉼표(,)를 사용하여 다음 섹션과 구분되어야 합니다.

각 섹션 이름은 INF 파일 내에서 고유해야 하며 섹션 이름을 정의하기 위한 일반 규칙을 따라야 합니다. 이러한 규칙에 대한 자세한 내용은 INF 파일에 대한 일반 구문 규칙을 참조하세요.

DDInstall 섹션에 지정된 모든 AddReg 지시문은 상위 또는 하위 필터 드라이버, 다기능 디바이스에 대한 정보 또는 드라이버 독립적이지만 디바이스별 매개 변수에 대한 정보를 저장하는 데 사용할 수 없는 추가 레지스트리 섹션을 참조하는 것으로 간주됩니다. 디바이스/드라이버 INF가 이러한 유형의 정보를 레지스트리에 저장해야 하는 경우 디코딩되지 않은 데코레이트된 DDInstall에서 AddReg 지시문을 사용해야 합니다. 다른 INF-writer 정의 add-registry-section을 참조하는 HW 섹션(있는 경우)입니다.

INF 버전 섹션에서 지정한 디바이스 설정 클래스에 따라 DDInstall 섹션에서 추가 클래스별 지시문을 지정할 수 있습니다. 클래스별 지시문에 대한 자세한 내용은 다음 topics 참조하세요.

예제

이 예제에서는 DDInstall 섹션, Ser_Inst 및 Inp_Inst 확장을 보여줍니다. 이러한 섹션은 INF 모델 섹션의 예제에서 참조됩니다.

[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles

[Ser_CopyFiles]
sermouse.sys

[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys

[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles

[Inp_CopyFiles]
inport.sys

다음 예제에서는 다양한 운영 체제 플랫폼에 오디오 디바이스용 시스템 제공 WDM 드라이버를 설치하는 INF 파일의 DDInstall 섹션을 보여 줍니다.

[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg

다음 예제에서는 시스템 제공 ks.inf 및 wdmaudio.inf 파일의 이전 요구 사항 항목에서 참조하는 섹션을 보여 줍니다. 앞의 예제에서 이러한 파일은 포함 항목에 지정됩니다. 운영 체제의 디바이스 설치 관리자가 이 디바이스의 install-section-name을 처리하는 경우 nt 섹션은 다음 두 섹션도 처리됩니다.

[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
    TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
    DeviceRegistration 
CopyFiles=KSProxy.Files,KSDriver.Files

[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;