Criando propriedades personalizadas do dispositivo

No Windows Vista e versões posteriores do Windows, o modelo unificado de propriedades de dispositivo oferece suporte à criação de categorias de propriedades de dispositivo personalizadas para instâncias de dispositivo, classes de configuração de dispositivo, classes de interface de dispositivo e interfaces de dispositivo. Uma propriedade personalizada pode ser acessada chamando a função de propriedade apropriada. Uma propriedade de dispositivo personalizada também pode ser modificada a partir de um pacote de driver usando uma diretiva INF AddProperty ou uma diretiva INF DelProperty.

Para obter mais informações sobre propriedades personalizadas do dispositivo, consulte as seguintes seções:

Criando categorias de propriedade de dispositivo personalizadas

Usando funções de propriedade para acessar propriedades de dispositivo personalizadas

Usando a diretiva INF AddProperty ou a diretiva INF DelProperty para modificar uma propriedade de dispositivo personalizada

** Criar Categorias de Propriedade de Dispositivo Personalizadas

Uma categoria de propriedade de dispositivo personalizada é uma coleção logicamente relacionada de propriedades de dispositivo personalizadas. Para criar programaticamente uma categoria de propriedade de dispositivo personalizada, use a macro DEFINE_DEVPROPKEY para criar as chaves de propriedade que representam as propriedades na categoria de propriedade, da seguinte maneira:

• Crie um valor GUID exclusivo que represente a categoria de propriedade e defina o valor GUID de cada chave de propriedade para esse valor GUID exclusivo. Para obter informações sobre como criar um novo valor de GUID, consulte Definindo e exportando novos GUIDs.

  Observação

  As categorias de propriedade definidas pelo sistema são reservadas apenas para uso do sistema operacional.

• Defina o identificador de propriedade de cada chave de propriedade como um valor inteiro que seja exclusivo dentro da categoria de propriedade e que seja maior ou igual a dois.

Você também pode criar uma categoria de propriedade de dispositivo personalizada para uma instância de dispositivo usando uma diretiva INF AddProperty.

Usando funções de propriedade para acessar propriedades de dispositivo personalizadas

Acesse as propriedades personalizadas do dispositivo da mesma maneira descrita em Acessando propriedades).

Usando a diretiva INF AddProperty ou a diretiva INF DelProperty para modificar uma propriedade de dispositivo personalizada

Para modificar uma propriedade de dispositivo personalizada usando uma diretiva INF AddProperty, inclua uma diretiva AddProperty na seção que instala o componente e forneça as seguintes entradas para a propriedade:

• A entrada property-category-guid que representa a categoria de propriedade de dispositivo personalizado

• Uma entrada de identificador de propriedade que identifica a propriedade dentro da categoria de propriedade de dispositivo personalizado

• A entrada de valor de uma nova propriedade de dispositivo ou a entrada de valor que modifica um valor de propriedade de dispositivo existente

Use a diretiva INF DelProperty para eliminar uma propriedade de dispositivo personalizada.

Para obter mais informações sobre como usar essas diretivas, consulte Usando a Diretiva INF AddProperty e a Diretiva INF DelProperty.