Funzione WdfDriverOpenPersistentStateRegistryKey (wdfdriver.h)
I driver devono usare WdfDriverOpenPersistentStateRegistryKey per scrivere informazioni persistenti a livello di driver nel Registro di sistema.
Sintassi
NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
[in] WDFDRIVER Driver,
[in] ACCESS_MASK DesiredAccess,
[in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
[out] WDFKEY *Key
);
Parametri
[in] Driver
Handle all'oggetto driver del framework del driver ottenuto da una chiamata precedente a WdfDriverCreate o WdfGetDriver.
[in] DesiredAccess
Valore digitato ACCESS_MASK che specifica una maschera di accesso per la chiave del Registro di sistema. Un driver KMDF richiede in genere KEY_READ, KEY_WRITE o KEY_READ KEY_WRITE | . Se si scrive un driver UMDF, usare KEY_READ o KEY_READ KEY_SET_VALUE | . Come procedura consigliata, chiedere solo i tipi di accesso necessari al driver.
[in, optional] KeyAttributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che specifica gli attributi degli oggetti per l'oggetto del Registro di sistema framework. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.
[out] Key
Puntatore a un percorso che riceve un handle a un oggetto del Registro di sistema framework.
Valore restituito
Fare riferimento a WdfDriverOpenParametersRegistryKey.
Commenti
La Parameters chiave è per le impostazioni non modificabili fornite nel file INF. Per accedere a queste impostazioni, usare WdfDriverOpenParametersRegistryKey. La chiave restituita da questa API è per le impostazioni scritte in fase di esecuzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 1803 |
| Versione KMDF minima | 1,25 |
| Versione UMDF minima | 2.25 |
| Intestazione | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |