Accesso alle impostazioni personalizzate

In Windows Vista e versioni successive di Windows, il modello di proprietà del dispositivo unificato supporta l'uso di chiavi di proprietà per creare e accedere alle proprietà personalizzate del dispositivo. Per altre informazioni, vedere Creazione di proprietà personalizzate del dispositivo.

In Windows Server 2003, Windows XP e Windows 2000 è possibile creare valori di voce del Registro di sistema personalizzati nelle chiavi del Registro di sistema fornite dal sistema per un componente correlato al dispositivo. L'elenco seguente contiene la funzione SetupAPI da chiamare per ogni tipo di componente del dispositivo per aprire la chiave del Registro di sistema fornita dal sistema corrispondente. Dopo aver aperto la chiave del Registro di sistema definita dal sistema, le applicazioni e i programmi di installazione possono chiamare le funzioni del Registro di sistema basate su Windows per modificare i valori delle voci del Registro di sistema personalizzate nella chiave del Registro di sistema aperta.

• Un valore di voce del Registro di sistema personalizzato per una proprietà hardware dell'istanza del dispositivo deve trovarsi nella chiave del Registro di sistema hardware di un'istanza del dispositivo. Chiamare SetupDiOpenDevRegKey e specificare DIREG_DEV nel parametro Flags per recuperare un handle nella chiave hardware di un'istanza del dispositivo. I valori di voce del Registro di sistema personalizzati impostati nella chiave del Registro di sistema hardware per un'istanza del dispositivo possono essere recuperati chiamando la funzione SetupDiGetCustomDeviceProperty .

• Un valore di voce del Registro di sistema personalizzato per una proprietà software dell'istanza del dispositivo deve trovarsi nella chiave del Registro di sistema software di un'istanza del dispositivo. Chiamare SetupDiOpenDevRegKey e specificare DIREG_DRV nel parametro Flags per recuperare un handle alla chiave software di un'istanza del dispositivo.

• Un valore di voce del Registro di sistema personalizzato per una proprietà della classe di installazione del dispositivo deve trovarsi nella chiave del Registro di sistema della classe di installazione del dispositivo. Chiamare SetupDiOpenClassRegKeyEx e specificare DIOCR_INSTALLER nel parametro Flags per recuperare un handle nella chiave del Registro di sistema per una classe di installazione del dispositivo.

• Un valore di voce del Registro di sistema personalizzato per una proprietà della classe dell'interfaccia del dispositivo deve trovarsi nella chiave del Registro di sistema della classe dell'interfaccia del dispositivo. Chiamare SetupDiOpenClassRegKeyEx e specificare DIOCR_INTERFACE nel parametro Flags per recuperare un handle nella chiave del Registro di sistema per una classe dell'interfaccia del dispositivo.

• Un valore di voce del Registro di sistema personalizzato per una proprietà dell'interfaccia del dispositivo deve trovarsi nella chiave del Registro di sistema dell'interfaccia del dispositivo. Chiamare SetupDiOpenDeviceInterfaceRegKey per recuperare un handle nella chiave del Registro di sistema per una classe dell'interfaccia del dispositivo.

Dopo aver recuperato un handle in una chiave del Registro di sistema, specificare l'handle in una chiamata a RegQueryValueEx o RegSetValueEx per recuperare o impostare il valore della voce personalizzata del Registro di sistema corrispondente alla proprietà del dispositivo personalizzata.

Chiamare la funzione RegCloseKey per chiudere la chiave del Registro di sistema dopo l'accesso alla chiave del Registro di sistema non è più necessaria.