INF Ini2Reg 지시문
주의
Windows 11 버전 22H2부터 이 지시문을 사용하는 드라이버 패키지는 더 이상 하드웨어 개발자 센터의 서명을 받을 수 없습니다.
유니버설 드라이버 패키지 및 Windows 드라이버는 이 지시문을 사용할 수 없습니다.
Ini2Reg 지시문은 제공된 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)
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ini2Reg 지시문에서 참조하는 명명된 각 섹션에는 다음과 같은 형식이 있습니다.
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
ini-to-registry-섹션은 각각 별도의 줄에 INF 작성기로 결정된 항목 수를 포함할 수 있습니다.
엔트리
ini-file
원본 미디어에 제공된 INI 파일의 이름을 지정합니다. 이 값은 파일 이름 또는 INF 파일의 문자열 섹션에 정의된 %strkey% 토큰으로 표현할 수 있습니다.
ini-section
복사할 레지스트리 정보를 포함하는 지정된 INI 파일 내의 섹션 이름을 지정합니다.
ini-key
레지스트리에 복사할 INI 파일의 키 이름을 지정합니다. 이 값을 생략하면 전체 ini-section 이 지정된 레지스트리 하위 키로 전송됩니다.
reg-root
이 항목에 제공된 다른 값에 대한 레지스트리 트리의 루트를 식별합니다. 자세한 내용은 AddReg 지시문에 대한 참조를 참조하세요.
하위 키
값을 받을 하위 키를 식별하며, INF의 문자열 섹션에 정의된 %strkey% 토큰 또는 지정된 reg-root에서 명시적 레지스트리 경로(key1\key2\key3...)로 표현됩니다.
flags
지정된 정보를 레지스트리로 전송한 후 INI 파일을 처리하는 방법 및/또는 기존 레지스트리 정보를 덮어쓸지 여부(비트 1)를 다음과 같이 지정합니다.
비트 0 = 0
레지스트리에 복사한 후 INI 파일에서 지정된 정보를 제거하지 마세요. 기본값입니다.
비트 0 = 1
레지스트리로 이동한 후 INI 파일에서 지정된 정보를 삭제합니다.
비트 1 = 0
지정된 하위 키가 레지스트리에 이미 있는 경우 INI 제공 정보를 이 하위 키로 전송하지 마세요. 그렇지 않으면 이 INI 제공 정보를 값 항목으로 사용하여 레지스트리에 지정된 하위 키를 만듭니다. 기본값입니다.
비트 1 = 1
지정된 하위 키가 레지스트리에 이미 있는 경우 해당 값 항목을 INI 제공 정보로 바꿉니다.
설명
Ini2Reg 지시문은 공식 구문 문에 표시된 모든 섹션에서 유효합니다. 이 지시문은 AddInterface 지시문에서 참조하거나 InterfaceInstall32 섹션에서 참조하는 INF 작성기 정의 섹션에서도 유효합니다.
INF 파일을 사용하여 Windows XP 이상 버전의 Windows에 디바이스를 설치하는 경우 INF 파일에 Ini2Reg 지시문이 포함되어서는 안 됩니다. Ini2Reg 지시문이 포함된 INF 파일은 "Windows용으로 디자인됨" 로고 테스트를 통과하지 않고 디지털 서명을 받지 않으므로 Windows에서 신뢰할 수 없습니다(Windows에서 드라이버를 선택하는 방법 참조).
각 ini-to-registry-section 이름은 INF 파일에 고유해야 합니다. 각 INF 작성기에서 만든 섹션 이름은 INF 파일 내에서 고유해야 하며 섹션 이름을 정의하기 위한 일반 규칙을 따라야 합니다. 이러한 규칙에 대한 자세한 내용은 INF 파일에 대한 일반 구문 규칙을 참조 하세요.
INF는 다음 방법 중 하나로 배포 미디어에 지정된 ini-file 의 전체 경로를 제공합니다.
IHV/OEM 제공 INF 파일에서 SourceDisksNames 및 이 INF의 SourceDisksFiles 섹션을 사용하여 배포 미디어의 루트 디렉터리(또는 디렉터리)에 없는 각 명명된 원본 파일의 전체 경로를 명시적으로 지정합니다.
시스템 제공 INF 파일에서 INF 파일의 버전 섹션에 있는 LayoutFile 항목에서 식별되는 하나 이상의 추가 INF 파일을 제공합니다.