Criando propriedades de dispositivo personalizadas

No Windows Vista e versões posteriores do Windows, o modelo de propriedade de dispositivo unificado dá suporte à criação de categorias de propriedade de dispositivo personalizadas para instâncias de dispositivo, classes de configuração de dispositivo, classes de interface do 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 de um pacote de driver usando uma diretiva AddProperty do INF 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 personalizado

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

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

Criando categorias de propriedade de dispositivo personalizado

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 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 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 AddProperty do INF.

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

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

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

Para modificar uma propriedade de dispositivo personalizada usando uma diretiva AddProperty do INF, 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 do dispositivo personalizado

• Uma entrada de identificador de propriedade que identifica a propriedade dentro da categoria de propriedade do 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 excluir uma propriedade de dispositivo personalizada.

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