INF UpdateInis 지시문
주의
Windows 11 버전 22H2부터 이 지시문을 사용하는 드라이버 패키지는 더 이상 하드웨어 개발자 센터의 서명을 받을 수 없습니다.
유니버설 드라이버 패키지 및 Windows 드라이버는 이 지시문을 사용할 수 없습니다.
UpdateInis 지시문은 하나 이상의 명명된 섹션을 참조하며, 특정 섹션 또는 줄을 읽고 대상 컴퓨터에서 동일한 이름의 기존 INI 파일에 적용할 INI 파일을 지정합니다. 필요에 따라 update-ini-section에서 이러한 INI 파일의 줄 단위 수정을 지정할 수 있습니다.
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
UpdateInis=update-ini-section[,update-ini-section]...
이 지시문은 INI 파일이 필요 없기 때문에 Windows에서 설치할 INF 파일에서 거의 지정되지 않습니다. 그러나 UpdateInis 지시문은 공식 구문 문에 표시된 섹션과 AddInterface 지시문에서 참조하거나 InterfaceInstall32 섹션에서 참조하는 INF 작성기 정의 섹션에서 유효합니다.
UpdateInis 지시문에서 참조하는 명명된 각 섹션에는 다음과 같은 형식이 있습니다.
[update-ini-section]
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...
update-ini-section은 각각 별도의 줄에 INF 기록기로 결정된 항목 수를 포함할 수 있습니다.
엔트리
ini-file
원본 미디어에 제공된 INI 파일의 이름과 대상 컴퓨터에서 업데이트할 INI 파일의 이름을 암시적으로 지정합니다. 이 값은 파일 이름 또는 INF 파일의 문자열 섹션에 정의된 %strkey% 토큰으로 표현할 수 있습니다.
ini-section
지정된 INI 파일 내의 섹션 이름을 지정합니다. 다음 두 값을 지정하면 이 섹션에는 변경할 항목이 포함됩니다. 이전-ini-entry이 생략되었지만 new-ini-entry이 제공된 경우 이 섹션을 읽을 때 새 항목이 추가됩니다.
old-ini-entry
이 선택적 값은 지정된 ini-section에 있는 항목의 이름을 지정하며, 일반적으로 다음 형식으로 표현됩니다.
"key=value"
키와 값 중 하나 또는 둘 다를 INF 파일의 문자열 섹션에 정의된 %strkey% 토큰으로 표현할 수 있습니다. 별표(*)는 키 또는 값에 대한 와일드카드로 지정할 수 있습니다.
new-ini-entry
이 선택적 값은 지정된 old-ini-entry에 대한 변경 또는 새 항목 추가를 지정합니다. 이 값은 이전-ini-entry과 동일한 방식으로 표현할 수 있습니다.
flags
이 선택적 값은 지정된 old-ini-entry 및/또는 new-ini-entry의 해석을 제어합니다. 플래그 항목은 다음 숫자 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
| 0 | 생략된 경우 플래그 항목의 기본값입니다. 지정된 이전-ini-entry 키가 INI 파일에 있는 경우 해당 key=value 를 지정된 new-ini-entry으로 바꿉다. INI 파일의 키만 일치해야 합니다. 이러한 각 키의 해당 값은 무시됩니다. 대상 INI 파일에 new-ini-entry을 무조건 추가하려면 INF의 update-ini 섹션에 있는 항목에서 이전-ini-entry 값을 생략합니다. 대상 INI 파일에서 이전-ini-entry을 무조건 삭제하려면 new-ini-entry 값을 생략합니다. |
| 1 | INI 파일에 지정된 old-ini-entry (key=value)이 있는 경우 지정된 new-ini-entry이 있는 대상 INI 파일로 바꿉니다. 지정된 old-ini-entry의 키와 값은 모두 INI 파일의 키와 일치해야만 이전 플래그 값에 대한 키뿐만 아니라 이러한 대체 항목이 만들어집니다. |
| 2 | 대상 INI 파일에서 old-ini-entry에 대해 지정된 키를 찾을 수 없는 경우 아무 것도 수행하지 않습니다. 그렇지 않은 경우 변경 내용은 다음과 같이 이전-ini-entry 및 new-ini-entry의 지정된 키에 대한 INI 파일에 있는 일치 항목에 따라 달라집니다. (1) INI 파일에 기존 ini-entry의 키가 있지만 new-ini-entry의 키도 마찬가지인 경우 이전-ini-entry을 대상 INI 파일의 new-ini-entry으로 바꾼 다음 해당 INI 파일에서 불필요한 new-ini-entry을 제거합니다. (2) INI 파일에 이전 ini-entry의 키가 있지만 new-ini-entry의 키가 없는 경우 이전-ini-entry 키를 대상 INI 파일의 new-ini-entry 키로 대체하지만 이전 ini-entry의 값은 변경되지 않은 상태로 둡니다. |
| 3 | INI 파일에서 old-ini-entry에 지정된 키와 값을 찾을 수 없는 경우 아무 것도 수행하지 않습니다. 그렇지 않은 경우 변경 내용은 다음과 같이 지정된 키에 대한 INI 파일의 일치 항목과 old-ini-entry 및 new-ini-entry의 값에 따라 달라집니다. (1) 이전 ini-entry의 key=value가 INI 파일에 있지만 new-ini-entry의 key=value도 마찬가지인 경우 이전-ini-entry을 대상 INI 파일의 new-ini-entry으로 바꾼 다음 해당 INI 파일에서 불필요한 new-ini-entry을 제거합니다. (2) INI 파일에 이전-ini-entry의 key=value가 있지만 new-ini-entry이 없으면 이전-ini-entry을 대상 INI 파일의 new-ini-entry으로 대체하지만 이전 ini-entry의 값은 변경되지 않은 상태로 둡니다. |
설명
지정된 update-ini-section 이름은 INF 파일 내에서 고유해야 하며 섹션 이름을 정의하기 위한 일반 규칙을 따라야 합니다. 이러한 규칙에 대한 자세한 내용은 INF 파일에 대한 일반 구문 규칙을 참조 하세요.
INF는 다음 방법 중 하나로 배포 미디어에 지정된 ini-file 의 전체 경로를 제공합니다.
IHV/OEM 제공 INF 파일에서 이 INF의 SourceDisksNames 및 SourceDisksFiles 섹션을 사용하여 배포 미디어의 루트 디렉터리(또는 디렉터리)에 없는 각 명명된 원본 파일의 전체 경로를 명시적으로 지정합니다.
시스템 제공 INF 파일에서 INF 파일의 버전 섹션에 있는 LayoutFile 항목에서 식별되는 하나 이상의 추가 INF 파일을 제공합니다.
이전-ini-entry 또는 new-ini-entry 내에 지정된 파일 이름은 해당 파일이 포함된 대상 디렉터리를 지정해야 합니다. update-ini-section 항목에서 파일 이름의 이러한 대상 디렉터리 경로를 dirid로 지정해야 합니다. 가능한 dirid 값 목록은 Dirids 사용을 참조 하세요.