Crear propiedades de dispositivo personalizadas

En Windows Vista y versiones posteriores de Windows, el modelo de propiedad de dispositivo unificado admite la creación de categorías de propiedades de dispositivo personalizadas para instancias de dispositivo, clases de configuració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 adecuada. 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 propiedades de dispositivo personalizadas

Usar la directiva AddProperty INF 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 relacionada lógicamente de propiedades de dispositivo personalizadas. 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.

  Nota:

  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 ú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 propiedades de dispositivo personalizadas

Acceda a las propiedades de dispositivo personalizadas de la misma manera que se describe en Obtener acceso a las 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:

• Entrada property-category-guid que representa la categoría de propiedad de dispositivo personalizada

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

• 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 la directiva Using the INF AddProperty y la Directiva INF DelProperty.