Diretiva INF DelProperty

Cuidado

Se você estiver criando um pacote universal ou do Windows Driver, essa diretiva não será válida. Consulte Usando um arquivo INF universal e Introdução com drivers do Windows.

Uma diretiva DelProperty faz referência a uma ou mais seções de arquivo INF que excluem propriedades do dispositivo para uma instância de dispositivo, uma classe de configuração de dispositivo, uma classe de interface do dispositivo ou uma interface do dispositivo.

[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)

Uma diretiva DelProperty pode ser especificada em qualquer uma das seções mostradas na instrução de sintaxe formal acima.

Uma del-property-section que é referenciada por uma diretiva DelProperty tem o seguinte formato:

[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]])
...

Uma del-property-section pode ter qualquer número de entradas de nome de propriedade ou entradas de guid de propriedade , cada uma em uma linha separada.

Entradas

property-name
Um dos nomes de propriedade que representam as propriedades do pacote de driver de instância do dispositivo. Os nomes de propriedade com suporte são os mesmos descritos para a entrada property-name da diretiva AddProperty do INF.

property-category-guid
Um valor GUID que identifica a categoria de propriedade. O valor guid pode ser um GUID definido pelo sistema que identifica uma categoria de propriedade definida pelo sistema ou um GUID personalizado que identifica uma categoria de propriedade personalizada. Os valores guid com suporte são os mesmos descritos para a entrada property-category-guid da diretiva AddProperty do INF.

property-pid
Um identificador de propriedade que indica a propriedade específica dentro da categoria de propriedade indicada pelo valor property-category-guid . Por motivos internos do sistema, um identificador de propriedade deve ser maior ou igual a dois.

sinalizadores
Um valor de sinalizador hexadecimal opcional que controla a operação de exclusão. O único valor de sinalizador com suporte é o seguinte:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Se o tipo de dados de propriedade for DEVPROP_TYPE_STRING_LIST, a operação excluirá todas as cadeias de caracteres com a lista de cadeias de caracteres existente que correspondem à cadeia de caracteres fornecida pelo valor de entrada de valor. O caso de um caractere não é considerado na comparação entre a cadeia de caracteres fornecida e uma cadeia de caracteres existente na lista de cadeias de caracteres.

value
Se o tipo de dados de propriedade for DEVPROP_TYPE_STRING_LIST e a entrada de sinalizadores for 0x00000001, o valor de entrada de valor fornecerá a cadeia de caracteres que a operação de exclusão usa para pesquisar cadeias de caracteres correspondentes na lista de cadeias de caracteres existente e, se uma cadeia de caracteres correspondente for encontrada, a operação de exclusão removerá a cadeia de caracteres correspondente da lista de cadeias de caracteres existente.

Comentários

Em geral, um arquivo INF não deve ser usado para excluir propriedades do dispositivo que podem ser definidas por um componente do sistema ou por outro arquivo INF. A principal finalidade da diretiva DelProperty é usar em um arquivo INF que atualiza uma instalação de dispositivo anterior e uma propriedade que foi definida para uma instalação de dispositivo anterior não é mais necessária.

Um nome del-property-section deve ser exclusivo em um arquivo INF, mas o nome da seção pode ser referenciado por mais de uma diretiva DelPropertyno mesmo arquivo INF. Um nome de seção deve seguir as regras gerais para definir nomes de seção descritos em Regras gerais de sintaxe para arquivos INF.

Para obter mais informações sobre como usar a diretiva DelProperty , consulte Using the INF AddProperty Directive and the INF DelProperty Directive.

Exemplos

O exemplo a seguir de uma seção de propriedade delete inclui duas entradas de linha: a entrada da primeira linha inclui um valor de entrada de nome de propriedade que exclui a propriedade DeviceModel e a segunda entrada de linha exclui a cadeia de caracteres "DeleteThisString" de um valor de propriedade de dispositivo personalizado cujo tipo de dados é DEVPROP_TYPE_STRING_LIST. Na segunda linha, o valor de entrada property-category-guid é "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", o valor de entrada do identificador de propriedade é "2" e o valor de entrada de sinalizadores é "0x00000001",

[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"

Confira também

Addproperty