Uso degli oggetti del framework Registry-Key

I driver basati su framework accedono al Registro di sistema usando oggetti chiave del Registro di sistema framework. L'oggetto chiave del Registro di sistema definisce metodi che consentono al driver di creare, aprire e chiudere le chiavi del Registro di sistema; aggiungere e rimuovere i valori del Registro di sistema; e leggere o scrivere i dati assegnati a un valore del Registro di sistema.

Per aprire una chiave del Registro di sistema, il driver deve chiamare WdfRegistryOpenKey. Se la chiave non esiste, il driver deve chiamare WdfRegistryCreateKey, che crea una nuova chiave e la apre.

Quando il driver apre una chiave del Registro di sistema, il framework crea un oggetto chiave del Registro di sistema che rappresenta la chiave aperta e restituisce un handle di oggetto al driver. Il driver deve usare l'handle dell'oggetto per accedere alla chiave, a tutte le sottochiavi esistenti nella chiave e a tutti i valori presenti nella chiave o nelle relative sottochiavi.

Per leggere i dati attualmente assegnati a un nome di valore del Registro di sistema, il driver può chiamare uno dei metodi oggetto seguenti:

WdfRegistryQueryMemory
Recupera i dati attualmente assegnati a un nome di valore, archivia i dati in un buffer allocato dal framework e crea un oggetto memoria framework per rappresentare il buffer.

WdfRegistryQueryMultiString
Recupera i dati stringa attualmente assegnati a un nome di valore tipizzato con più stringhe, crea un oggetto stringa framework per ogni stringa e aggiunge ogni oggetto stringa a una raccolta di oggetti.

WdfRegistryQueryString
Recupera i dati stringa attualmente assegnati a un nome di valore tipizzato da stringa e assegna la stringa a un oggetto stringa framework specificato.

WdfRegistryQueryUnicodeString
Recupera i dati stringa attualmente assegnati a un nome di valore di tipo stringa e copia la stringa in una struttura di UNICODE_STRING specificata.

WdfRegistryQueryULong
Recupera i dati di una parola lunga senza segno (REG_DWORD) attualmente assegnati a un nome di valore e copia i dati in una posizione specificata.

WdfRegistryQueryValue
Recupera i dati attualmente assegnati a un nome di valore e copia i dati in un buffer fornito dal driver.

Per scrivere dati in un valore del Registro di sistema, il driver può chiamare uno dei metodi seguenti. Se il nome del valore esiste già, il sistema operativo aggiorna i dati del valore.

WdfRegistryAssignMemory
Assegna i dati contenuti in un buffer di memoria a un nome di valore specificato nel Registro di sistema.

WdfRegistryAssignMultiString
Assegna un set di stringhe a un nome di valore specificato nel Registro di sistema. Le stringhe sono contenute in una raccolta di oggetti stringa del framework fornita dal driver.

WdfRegistryAssignString
Assegna una stringa a un nome di valore specificato nel Registro di sistema. La stringa è contenuta in un oggetto stringa del framework.

WdfRegistryAssignUnicodeString
Assegna una stringa Unicode specificata a un nome di valore specificato nel Registro di sistema.

WdfRegistryAssignULong
Assegna un valore di tipo unsigned long specificato a un nome di valore specificato nel registro.

WdfRegistryAssignValue
Assegna il contenuto di un buffer di dati fornito dal driver a un nome di valore specificato nel Registro di sistema.

Per rimuovere un valore del Registro di sistema, il driver deve chiamare WdfRegistryRemoveValue. Per rimuovere una chiave, il driver deve chiamare WdfRegistryRemoveKey.

Per ottenere informazioni WDM sul Registro di sistema, un driver può chiamare WdfRegistryWdmGetHandle, che restituisce un handle WDM alla chiave del Registro di sistema rappresentata da un oggetto chiave del Registro di sistema del framework.

Al termine dell'accesso a una chiave del Registro di sistema, il driver deve chiamare WdfRegistryClose o WdfObjectDelete per chiudere la chiave ed eliminare l'oggetto chiave del Registro di sistema.