Funzione WdfDriverOpenPersistentStateRegistryKey (wdfdriver.h)

  • Articolo

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

Vedi anche

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE