INF DelProperty 지시문
주의
유니버설 또는 Windows 드라이버 패키지를 빌드하는 경우 이 지시문이 잘못되었습니다. 유니버설 INF 파일 사용 및 Windows 드라이버 개발 시작을 참조하세요.
DelProperty 지시문은 디바이스 인스턴스, 디바이스 설정 클래스, 디바이스 인터페이스 클래스 또는 디바이스 인터페이스에 대한 디바이스 속성을 삭제하는 하나 이상의 INF 파일 섹션을 참조합니다.
[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)
[interface-install-section] |
[interface-install-section.nt] |
[interface-install-section.ntx86] |
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[add-interface-section]
DelProperty=del-property-section[,del-property-section]... (Windows Vista and later versions of Windows)
위의 공식 구문 문에 표시된 섹션 아래에 DelProperty 지시문을 지정할 수 있습니다.
DelProperty 지시문에서 참조하는 del-property-section의 형식은 다음과 같습니다.
[del-property-section]
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
...
del-property-section에는 각각 별도의 줄에 속성 이름 항목 또는 property-guid 항목이 있을 수 있습니다.
엔트리
property-name
디바이스 인스턴스 드라이버 패키지 속성을 나타내는 속성 이름 중 하나입니다. 지원되는 속성 이름은 INF AddProperty 지시문의 속성 이름 항목에 대해 설명된 이름과 동일합니다.
property-category-guid
속성 범주를 식별하는 GUID 값입니다. GUID 값은 시스템 정의 속성 범주 또는 사용자 지정 속성 범주를 식별하는 사용자 지정 GUID를 식별하는 시스템 정의 GUID일 수 있습니다. 지원되는 GUID 값은 INF AddProperty 지시문의 property-category-guid 항목에 대해 설명된 값과 동일합니다.
property-pid
속성 범주-guid 값으로 표시되는 속성 범주 내의 특정 속성을 나타내는 속성 식별자입니다. 내부 시스템상의 이유로 속성 식별자는 2보다 크거나 같아야 합니다.
flags
삭제 작업을 제어하는 선택적 16진수 플래그 값입니다. 지원되는 유일한 플래그 값은 다음과 같습니다.
0x00000001(FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
속성 데이터 형식이 DEVPROP_TYPE_STRING_LIST 경우 작업에서는 값 항목 값에서 제공하는 문자열과 일치하는 기존 문자열 목록이 있는 모든 문자열을 삭제합니다. 문자열 목록의 제공된 문자열과 기존 문자열 간의 비교에서 문자의 경우는 고려되지 않습니다.
value
속성 데이터 형식이 DEVPROP_TYPE_STRING_LIST 플래그 항목이 0x00000001 경우 값 항목 값은 삭제 작업에서 기존 문자열 목록에서 일치하는 문자열을 검색하는 데 사용하는 문자열을 제공하고 일치하는 문자열이 발견되면 삭제 작업은 기존 문자열 목록에서 일치하는 문자열을 제거합니다.
설명
일반적으로 INF 파일은 시스템 구성 요소 또는 다른 INF 파일에서 설정할 수 있는 디바이스 속성을 삭제하는 데 사용하면 안 됩니다. DelProperty 지시문의 주요 목적은 이전 디바이스 설치를 업데이트하는 INF 파일에서 사용하기 위한 것이며 이전 디바이스 설치에 대해 설정된 속성은 더 이상 필요하지 않습니다.
del-property-section 이름은 INF 파일 내에서 고유해야 하지만 동일한 INF 파일에서 둘 이상의 DelProperty지시문에서 섹션 이름을 참조할 수 있습니다. 섹션 이름은 INF 파일의 일반 구문 규칙에 설명된 섹션 이름을 정의하기 위한 일반 규칙을 따라야 합니다.
DelProperty 지시문을 사용하는 방법에 대한 자세한 내용은 INF AddProperty 지시문 및 INF DelProperty 지시문 사용을 참조하세요.
예제
삭제 속성 섹션의 다음 예제에는 두 줄 항목이 포함됩니다. 첫 번째 줄 항목에는 DeviceModel 속성을 삭제하는 속성 이름 항목 값이 포함되고, 두 번째 줄 항목은 데이터 형식이 DEVPROP_TYPE_STRING_LIST 사용자 지정 디바이스 속성 값에서 "DeleteThisString" 문자열을 삭제합니다. 두 번째 줄 에서 property-category-guid 항목 값은 "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e" 이며, 속성 식별자 항목 값은 "2"이고 플래그 항목 값은 "0x00000001"입니다.
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"