Diretiva INF DelProperty
Cuidado
Se você estiver criando um pacote de drivers universal ou do Windows, essa diretiva não será válida. Consulte Usar um arquivo INF universal e Introdução ao desenvolvimento de drivers do Windows.
Uma diretiva DelProperty faz referência a uma ou mais seções do arquivo INF que excluem propriedades de dispositivo para uma instância de dispositivo, uma classe de configuração de dispositivo, uma classe de interface de dispositivo ou uma interface de 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 referenciada por uma diretiva DelProperty fica com o formato a seguir:
[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 quaisquer números de entradas de property-name ou de property-guid, cada uma em uma linha separada.
Entradas
nome da propriedade
Um dos nomes de propriedade que representam as propriedades do driver package das instâncias 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 de 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 indicador compatível é o seguinte:
0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Se o tipo de dados da propriedade for DEVPROP_TYPE_STRING_LIST, a operação excluirá todas as cadeias de caracteres com a lista de cadeias de caracteres que correspondem à cadeia de caracteres fornecida pelo valor de entrada de valor. O uso de maiúsculas e minúsculas em 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 dado da propriedade for DEVPROP_TYPE_STRING_LIST e a entrada de sinalizadores for 0x00000001, value 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 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.
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 finalidade principal da diretiva DelProperty é o uso em um arquivo INF que atualiza uma instalação de dispositivo anterior quando 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 descritas em Regras gerais de sintaxe para arquivos INF.
Para mais detalhes sobre o uso da diretiva DelProperty, consulte Usar a diretiva INF AddProperty e a diretiva INF DelProperty.
Exemplos
O exemplo a seguir de uma seção de propriedade de exclusão inclui duas entradas de linha: a primeira inclui um valor de entrada property-name que exclui a propriedade DeviceModel; a segunda 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 da entrada property-category-guid é "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", o valor da entrada property-identifier é "2" e o valor da entrada flags é "0x00000001"
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"