Valores de entrada de arquivo INF que modificam propriedades do dispositivo antes do Windows Vista

A seguir estão os valores de entrada de arquivo INF que modificam as propriedades do dispositivo no Windows Server 2003, Windows XP e Windows 2000:

• Valores de entrada de arquivo INF que definem as propriedades do dispositivo que correspondem às propriedades do dispositivo definidas pelo sistema que fazem parte do modelo de propriedade de dispositivo unificado no Windows Vista e versões posteriores do Windows.

• Diretivas INF AddReg e diretivas INF DelReg que definem ou excluem valores de entrada do Registro definidos pelo sistema que correspondem às propriedades do dispositivo definidas pelo sistema que fazem parte do modelo de propriedade de dispositivo unificado no Windows Vista e versões posteriores.

• Diretivas INF AddReg e diretivas INF DelReg que definem ou excluem valores de entrada do Registro personalizados que correspondem às propriedades personalizadas do dispositivo.

Para obter informações gerais sobre as seções de arquivo INF que instalam instâncias de dispositivo, classes de configuração de dispositivo, classes de interface de dispositivo e interfaces de dispositivo, consulte os seguintes tópicos:

• Secção INF DDInstall
• Seção INF ClassInstall32
• Seção INF InterfaceInstall32
• INF DDInstall. Secção Interfaces

Valores de entrada de arquivo INF que correspondem às propriedades do dispositivo System-Defined

Alguns valores de entrada de arquivo INF fornecem informações que o Windows usa para definir os valores de entrada do Registro definidos pelo sistema que correspondem às propriedades da instância do dispositivo e às propriedades da interface do dispositivo. A seguir estão alguns exemplos de valores de entrada do Registro que são fornecidos por esses valores de entrada de arquivo INF:

• A seção Modelos INF em um arquivo INF inclui um valor de entrada descrição do dispositivo. Esse valor corresponde à propriedade DEVPKEY_Device_DeviceDesc no modelo de propriedade de dispositivo unificado e pode ser recuperado chamando CM_Get_DevNode_Registry_Property com um parâmetro ulProperty de CM_DRP_DEVICEDESC ou chamando SetupDiGetDeviceRegistryProperty com um parâmetro Property de SPDRP_DEVICEDESC.

• A diretiva de classe INF de uma seção Versão INF inclui um valor de entrada de nome de classe que fornece o nome de uma classe de configuração de dispositivo. Esse valor corresponde à propriedade DEVPKEY_DeviceClass_ClassName no modelo de propriedade de dispositivo unificado. O nome da classe para uma classe de configuração de dispositivo pode ser obtido chamando SetupDiClassNameFromGuid, e o nome da classe de uma instância de dispositivo pode ser obtido chamando CM_Get_DevNode_Registry_Property com um parâmetro ulProperty de CM_DRP_CLASS ou chamando SetupDiGetDeviceRegistryProperty com um parâmetro Property de SPDRP_CLASS.

• A seção INF InterfaceInstall32 inclui um valor de entrada InterfaceClassGuid que fornece o GUID de uma interface de dispositivo. Esse valor corresponde à propriedade DEVPKEY_DeviceInterface_ClassGuid no modelo de propriedade de dispositivo unificado. O GUID de uma interface de dispositivo pode ser obtido chamando SetupDiEnumDeviceInterfaces, que obtém uma estrutura SP_DEVICE_INTERFACE_DATA para as interfaces de dispositivo associadas a uma instância de dispositivo. O membro InterfaceClassGuid da estrutura SP_DEVICE_INTERFACE_DATA identifica o GUID da classe de interface.

Diretivas INF AddReg e Diretivas INF DelReg que modificam as propriedades do dispositivo System-Defined

Muitas propriedades de dispositivo definidas pelo sistema têm valores de entrada de registro correspondentes definidos pelo sistema. Para propriedades de dispositivo que têm valores de entrada do Registro correspondentes, usar uma diretiva INF AddReg para adicionar o valor de entrada do Registro correspondente define a propriedade do dispositivo correspondente. Da mesma forma, usando uma diretiva INF DelReg para excluir o valor de entrada do Registro correspondente, também exclui a propriedade do dispositivo correspondente.

Por exemplo, a diretiva INF AddReg na seção "Abc_Device_Install.HW" a seguir definiria o valor de entrada do Registro DeviceCharacteristics para uma instância de dispositivo:

[Abc_Device_Install.HW]
...
AddReg = Xxx_AddReg
...
[Xxx_AddReg]
...
[HKR,,DeviceCharacteristics,0x10001,0x00000001
] 

O valor da entrada do Registro DeviceCharacteristics corresponde à propriedade DEVPKEY_Device_Characteristics no modelo de propriedade de dispositivo unificado no Windows Vista e versões posteriores do Windows.

Diretivas INF AddReg e diretivas INF DelReg que modificam valores de entrada de registro personalizados

O Windows gerencia a correspondência entre os valores de entrada do Registro definidos pelo sistema e as propriedades do dispositivo definidas pelo sistema. No entanto, o Windows não gerencia a correspondência entre valores de entrada de registro personalizados e propriedades de dispositivo personalizado. Uma diretiva INF AddReg ou uma diretiva INF DelReg que modifica um valor de entrada de registro personalizado não afeta as propriedades definidas pelo sistema que o Windows gerencia.

As propriedades de instância de dispositivo personalizadas definidas como mostrado no exemplo a seguir podem ser recuperadas chamando SetupDiGetCustomDeviceProperty.

[XxxDDInstall.HW]
...
AddReg = Xxx_AddReg
...
[Xxx_AddReg]
...
[HKR,,CustomPropertyName,0x10001,0x00000001
] 

Para obter mais informações sobre como acessar propriedades de dispositivo personalizadas que têm valores de entrada de registro personalizados correspondentes, consulte Acessando propriedades de dispositivo personalizadas.