INF UpdateInis 지시문

아티클
07/20/2023

주의

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-writer 정의 섹션에서 유효합니다.

UpdateInis 지시문에서 참조하는 명명된 각 섹션에는 다음과 같은 형식이 있습니다.

[update-ini-section]
 
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...

update-ini-section은 각각 별도의 줄에 INF 작성기로 결정된 항목 수를 포함할 수 있습니다.

항목

ini-file
원본 미디어에 제공된 INI 파일의 이름을 지정하고 암시적으로 대상 컴퓨터에서 업데이트할 INI 파일의 이름을 지정합니다. 이 값은 파일 이름 또는 INF 파일의 Strings 섹션에 정의된 %strkey% 토큰으로 표현할 수 있습니다.

ini-section
지정된 INI 파일 내의 섹션 이름을 지정합니다. 다음 두 값을 지정하면 이 섹션에는 변경할 항목이 포함됩니다. 이전-ini-entry을 생략했지만 new-ini-entry이 제공된 경우 이 섹션을 읽을 때 새 항목이 추가됩니다.

old-ini-entry
이 선택적 값은 지정된 ini-section에 있는 항목의 이름을 지정하며, 일반적으로 다음 형식으로 표현됩니다.

"key=value"

키와 값 중 하나 또는 둘 다를 INF 파일의 Strings 섹션에 정의된 %strkey% 토큰으로 표현할 수 있습니다. 별표(*)는 키 또는 값에 대한 야생 카드 지정할 수 있습니다.

new-ini-entry
이 선택적 값은 지정된 old-ini-entry 에 대한 변경 또는 새 항목 추가를 지정합니다. 이 값은 old-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 섹션에 있는 항목에서 old-ini-entry 값을 생략합니다. 대상 INI 파일에서 old-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-entry의 키가 INI 파일에 있지만 new-ini-entry의 키도 마찬가지인 경우 이전 ini-entry을 대상 INI 파일의 new-ini-entry으로 바꾼 다음 해당 INI 파일에서 불필요한 new-ini-entry을 제거합니다. (2) INI 파일에 old-ini-entry의 키가 있지만 new-ini-entry의 키가 없으면 이전 ini 항목키를 대상 INI 파일의 new-ini-entry 키로 대체하지만 이전 ini 항목의 값은 변경되지 않은 상태로 둡니다.
3	INI 파일에서 old-ini-entry에 지정된 키와 값을 찾을 수 없는 경우 아무 것도 수행하지 않습니다. 그렇지 않으면 변경된 내용은 다음과 같이 지정된 키 및 old-ini-entry 및 new-ini-entry 값에 대한 INI 파일에 있는 일치 항목에 따라 달라집니다. (1) 이전 ini-entry의 key=value가 INI 파일에 있지만 new-ini-entry의 key=value를 수행하는 경우 이전 ini-entry을 대상 INI 파일의 new-ini-entry으로 바꾼 다음 해당 INI 파일에서 불필요한 new-ini-entry을 제거합니다. (2) INI 파일에 old-ini-entry의 key=value가 있지만 new-ini-entry이 없으면 대상 INI 파일의 new-ini-entry으로 old-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 사용을 참조하세요.