Creación de propiedades personalizadas de dispositivos

En Windows Vista y versiones posteriores de Windows, el modelo de propiedades de dispositivo unificado admite la creación de categorías de propiedades de dispositivo personalizadas para instancias de dispositivo, clases de instalación de dispositivos, clases de interfaz de dispositivo e interfaces de dispositivo. Se puede acceder a una propiedad personalizada llamando a la función de propiedad apropiada. Una propiedad de dispositivo personalizada también se puede modificar desde un paquete de controladores mediante una directiva AddProperty INF o una directiva INF DelProperty.

Para obtener más información sobre las propiedades de dispositivo personalizadas, consulte las secciones siguientes:

Crear categorías de propiedades de dispositivo personalizadas

Uso de funciones de propiedad para acceder a las propiedades de dispositivo personalizadas

Usar la directiva INF AddProperty o la directiva INF DelProperty para modificar una propiedad de dispositivo personalizada

Crear categorías de propiedades de dispositivo personalizadas

Una categoría de propiedad de dispositivo personalizada es una colección de propiedades de dispositivo personalizadas relacionadas lógicamente. Para crear mediante programación una categoría de propiedad de dispositivo personalizada, use la macro DEFINE_DEVPROPKEY para crear las claves de propiedad que representan las propiedades de la categoría de propiedad, como se indica a continuación:

• Cree un valor GUID único que represente la categoría de propiedad y establezca el valor GUID de cada clave de propiedad en este valor GUID único. Para obtener información sobre cómo crear un nuevo valor GUID, consulte Definición y exportación de nuevos GUID.

  Note

  Las categorías de propiedades definidas por el sistema se reservan solo para uso del sistema operativo.

• Establezca el identificador de propiedad de cada clave de propiedad en un valor entero que sea único dentro de la categoría de propiedad y que sea mayor o igual que dos.

También puede crear una categoría de propiedad de dispositivo personalizada para una instancia de dispositivo mediante una directiva AddProperty INF.

Uso de funciones de propiedad para acceder a las propiedades de dispositivo personalizadas

Acceder a las propiedades personalizadas del dispositivo del mismo modo que se describe en Acceder a propiedades).

Usar la directiva AddProperty inf o la directiva INF DelProperty para modificar una propiedad de dispositivo personalizada

Para modificar una propiedad de dispositivo personalizada mediante una directiva ADDProperty INF, incluya una directiva AddProperty en la sección que instala el componente y proporcione las siguientes entradas para la propiedad :

• La entrada property-category-guid que representa la categoría de propiedad del dispositivo personalizado

• Entrada de identificador de propiedad que identifica la propiedad dentro de la categoría de propiedad de dispositivo personalizada

• Entrada de valor de una nueva propiedad de dispositivo o la entrada de valor que modifica un valor de propiedad de dispositivo existente

Use la directiva INF DelProperty para eliminar una propiedad de dispositivo personalizada.

Para obtener más información sobre cómo usar estas directivas, vea Uso de la directiva INF AddProperty y la directiva INF DelProperty.