Creazione di proprietà personalizzate del dispositivo

In Windows Vista e versioni successive di Windows, il modello di proprietà dispositivo unificato supporta la creazione di categorie di proprietà del dispositivo personalizzate per le istanze del dispositivo, le classi di installazione del dispositivo, le classi di interfaccia del dispositivo e le interfacce del dispositivo. È possibile accedere a una proprietà personalizzata chiamando la funzione di proprietà appropriata. Una proprietà del dispositivo personalizzata può essere modificata anche da un pacchetto driver usando una direttiva INF AddProperty o una direttiva INF DelProperty.

Per altre informazioni sulle proprietà personalizzate del dispositivo, vedere le sezioni seguenti:

Creazione di categorie di proprietà del dispositivo personalizzate

Uso delle funzioni di proprietà per accedere alle proprietà personalizzate del dispositivo

Utilizzo della direttiva INF AddProperty o della direttiva INF DelProperty per modificare una proprietà del dispositivo personalizzata

Creazione di categorie di proprietà del dispositivo personalizzate

Una categoria di proprietà del dispositivo personalizzata è una raccolta logicamente correlata alle proprietà del dispositivo personalizzate. Per creare una categoria di proprietà del dispositivo personalizzata a livello di codice, utilizzare la macro DEFINE_DEVPROPKEY per creare le chiavi di proprietà che rappresentano le proprietà nella categoria di proprietà, come indicato di seguito:

• Creare un valore GUID univoco che rappresenta la categoria di proprietà e impostare il valore GUID di ogni chiave di proprietà su questo valore GUID univoco. Per informazioni su come creare un nuovo valore GUID, vedere Definizione ed esportazione di nuovi GUID.

  Nota

  Le categorie di proprietà definite dal sistema sono riservate solo per l'uso del sistema operativo.

• Impostare l'identificatore della proprietà di ogni chiave di proprietà su un valore intero univoco all'interno della categoria di proprietà e maggiore o uguale a due.

È anche possibile creare una categoria di proprietà del dispositivo personalizzata per un'istanza del dispositivo usando una direttiva INF AddProperty.

Uso delle funzioni di proprietà per accedere alle proprietà personalizzate del dispositivo

Accedere alle proprietà personalizzate del dispositivo nello stesso modo descritto in Accesso alle proprietà.

Utilizzo della direttiva INF AddProperty o della direttiva INF DelProperty per modificare una proprietà del dispositivo personalizzata

Per modificare una proprietà del dispositivo personalizzata utilizzando una direttiva ADDProperty INF, includere una direttiva AddProperty nella sezione che installa il componente e fornire le voci seguenti per la proprietà :

• Voce property-category-guid che rappresenta la categoria di proprietà del dispositivo personalizzata

• Voce dell'identificatore di proprietà che identifica la proprietà all'interno della categoria di proprietà del dispositivo personalizzata

• Voce di valore di una nuova proprietà del dispositivo o della voce di valore che modifica un valore della proprietà del dispositivo esistente

Usare la direttiva INF DelProperty per eliminare una proprietà del dispositivo personalizzata.

Per altre informazioni su come usare queste direttive, vedere la direttiva Using the INF AddProperty Directive and the INF DelProperty Directive.For more information about how to use these directive, see the Using the INF AddProperty Directive and the INF DelProperty Directive.