다음을 통해 공유

INF AddProperty 지시문 및 INF DelProperty 지시문 사용

  • 아티클

Windows Vista 이상 버전의 Windows에서는 INF AddProperty 지시문 및 INF DelProperty 지시문을 사용하여 디바이스 인스턴스, 디바이스 설정 클래스, 디바이스 인터페이스 클래스 및 디바이스 인터페이스에 대한 속성을 설정하고 삭제할 수 있습니다. 여기에는 시스템 정의 디바이스 속성 및 사용자 지정 디바이스 속성이 포함됩니다. 그러나 INF AddReg 지시문 및 INF DelReg 지시문 대신 AddProperty 및 DelProperty 지시문을 사용하여 디바이스 속성을 설정하고 삭제하는 경우 다음 지침을 사용해야 합니다.

  • Windows Vista 이상 버전의 Windows에서 도입된 디바이스 속성의 경우 AddProperty 및 DelProperty 지시문을 사용하여 디바이스 속성을 설정하고 삭제해야 합니다.

  • Windows Server 2003, Windows XP 또는 Windows 2000에서 도입되었으며 AddReg 지시문에 의해 설정되고 DelReg 지시문에 의해 삭제될 수 있는 디바이스 속성의 경우 계속해서 AddReg 및 DelReg 지시문을 사용하여 이러한 디바이스 속성을 설정하고 삭제해야 합니다. AddProperty 및 DelProperty 지시문을 사용하면 안 됩니다.

다음 INF 파일 섹션에 INF AddProperty 지시문 및 INF DelProperty 지시문을 포함하여 디바이스 인스턴스, 디바이스 설정 클래스, 디바이스 인터페이스 클래스 및 디바이스 인터페이스에 대한 속성을 설정하고 삭제할 수 있습니다.

INF AddProperty 지시문 사용

속성 값을 수정하려면 디바이스 인스턴스, 디바이스 설정 클래스, 디바이스 인터페이스 클래스 또는 디바이스 인터페이스를 설치하는 섹션에 INF AddProperty 지시문을 포함합니다. AddProperty 지시문은 속성을 지정하는 항목, 속성을 수정하는 방법 및 속성을 수정하는 데 사용되는 값을 포함하는 하나 이상의 추가 속성 섹션을 참조합니다. AddProperty 지시문의 형식은 다음과 같습니다.

AddProperty=add-property-section[,add-property-section] ...

add-property-section의 각 줄은 하나의 속성을 지정합니다. 다음은 속성 정보를 지정하는 두 가지 가능한 줄 형식을 보여 줍니다. 표시된 첫 번째 줄 형식은 해당 이름으로 속성을 지정합니다. 이 형식은 DEVPKEY_DrvPkg_Xxx 속성에만 사용할 수 있습니다. 두 번째 줄 형식은 속성 범주별로 속성을 지정하고 해당 속성 키의 속성 식별자를 지정합니다. 이 두 번째 형식은 시스템 정의 속성 또는 사용자 지정 디바이스 속성을 지정하는 데 사용할 수 있습니다.

[add-property-section]property-name,,,[flags],value{property-category-guid},property-pid,type,[flags],value 항목 값은 다음을 제공합니다.

property-name
DEVPKEY_DrvPkg_Xxx 속성을 식별하는 이름입니다. 예를 들어 DEVPKEY_DrvPkg_Model 속성을 나타내는 DeviceModel 또는 DEVPKEY_DrvPkg_VendorWebSite 속성을 나타내는 DeviceVendorWebSite입니다.

property-category-guid
속성이 속한 속성 범주의 GUID 값입니다. 예를 들어 시스템 정의 DEVPKEY_Device_FriendlyName 속성입니다. GUID 값은 사용자 지정 디바이스 범주를 지정할 수도 있습니다.

property-pid
속성 범주 내의 속성을 식별하는 속성 식별자입니다. 예를 들어 DEVPKEY_Device_FriendlyName 속성의 속성 식별자 값은 14입니다.

Flags
속성 값을 수정하는 방법을 나타내는 선택적 플래그입니다.

Type
데이터 형식을 지정하는 속성 데이터 형식 식별자입니다.

value
속성 값을 수정하는 데 사용되는 값입니다.

AddProperty 지시문의 다음 예제에는 두 개의 줄 항목이 포함됩니다. 첫 번째 줄에는 속성 이름 항목 값 "DeviceModel"과 값 항목 값 "샘플 디바이스 모델 이름"이 포함됩니다. 이 항목은 DEVPKEY_DrvPkg_Model 속성을 설정합니다. 두 번째 줄 항목은 사용자 지정 속성 범주에서 사용자 지정 속성을 설정합니다. property-category-guid 항목 값은 "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e"이며 속성 식별자 항목 값은 "2"입니다. 선택적 플래그 항목 값이 없으며 형식 항목 값은 "18"(DEVPROP_TYPE_STRING)입니다. 값 항목 값은 "속성 1의 문자열 값"입니다.

[Root_Install.NT]
AddProperty=Root_AddProperty

[Root_AddProperty]
DeviceModel,,,,"Sample Device Model Name"
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 18,, "String value for property 1"

INF DelProperty 지시문 사용

속성을 삭제하려면 디바이스 인스턴스, 디바이스 설정 클래스, 디바이스 인터페이스 클래스 또는 디바이스 인터페이스를 설치하는 섹션에 INF DelProperty 지시문을 포함합니다.

INF DelProperty 지시문의 주요 목적은 디바이스 설치를 업데이트하는 INF 파일에서 사용하기 위한 것입니다. 이 경우 DelProperty 지시문을 사용하여 이전 설치에서 설정한 속성을 삭제할 수 있지만 업데이트된 설치에서는 더 이상 필요하지 않습니다. DelProperty 지시문을 주의해서 사용합니다. DelProperty 는 시스템 구성 요소 또는 다른 INF 파일에서 설정할 수도 있는 속성을 삭제하는 데 사용하면 안 됩니다.

DelProperty 지시문의 형식은 다음과 같습니다.

DelProperty=del-property-section[,del-property-section] ...

del-property-section의 각 줄은 하나의 속성을 지정합니다. 다음은 속성 정보를 지정하는 두 가지 가능한 줄 형식을 보여 줍니다. 표시된 첫 번째 줄 형식은 해당 이름으로 속성을 지정합니다. 이 형식은 DEVPKEY_DrvPkg_Xxx 속성에만 사용할 수 있습니다. 두 번째 줄 형식은 속성 범주별로 속성을 지정하고 해당 속성 키의 속성 식별자를 지정합니다. 두 번째 형식을 사용하여 시스템 정의 속성 또는 사용자 지정 디바이스 속성을 지정할 수 있습니다.

[del-property-section]property-name [,, Flags [,value]] {property-category-guid}, property-pid [, Flags [,value]] 항목 값은 다음을 제공합니다.

property-name
DEVPKEY_DrvPkg_Xxx 속성을 식별하는 이름입니다. 예를 들어 DEVPKEY_DrvPkg_Model 속성을 나타내는 DeviceModel 또는 DEVPKEY_Device_FriendlyName 속성을 나타내는 DeviceVendorWebSite입니다.

property-category-guid
속성이 속한 속성 범주의 GUID 값입니다. 예를 들어 시스템 정의 DEVPKEY_Device_FriendlyName 속성입니다. GUID 값은 사용자 지정 디바이스 범주를 지정할 수도 있습니다.

property-pid
속성 범주 내의 속성을 식별하는 속성 식별자입니다. 예를 들어 DEVPKEY_Device_FriendlyName 속성의 속성 식별자 값은 14입니다.

Flags
데이터 형식이 DEVPROP_TYPE_STRING_LIST 속성에만 사용할 수 있는 선택적 플래그입니다. 플래그가 설정되면 삭제 작업은 속성 문자열 목록에서 값으로 지정된 문자열을 삭제합니다.

value
속성 문자열 목록에서 삭제할 문자열입니다.

del-property-section의 다음 예제에는 두 줄 항목이 포함됩니다.

첫 번째 줄에는 DEVPKEY_DrvPkg_Model 속성을 삭제하는 속성 이름 항목 값 "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"