WdfDriverOpenPersistentStateRegistryKey, fonction (wdfdriver.h)

Les pilotes doivent utiliser WdfDriverOpenPersistentStateRegistryKey pour écrire des informations persistantes à l’échelle du pilote dans le Registre.

Syntaxe

NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
  [in]           WDFDRIVER              Driver,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

Paramètres

[in] Driver

Handle de l’objet de pilote d’infrastructure du pilote que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfGetDriver.

[in] DesiredAccess

Une ACCESS_MASK valeur typée qui spécifie un masque d’accès pour la clé de Registre. Un pilote KMDF demande généralement KEY_READ, KEY_WRITE ou KEY_READ | KEY_WRITE. Si vous écrivez un pilote UMDF, utilisez KEY_READ ou KEY_READ | KEY_SET_VALUE. Comme meilleure pratique, demandez uniquement les types d’accès dont votre pilote a besoin.

[in, optional] KeyAttributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES allouée à l’appelant qui spécifie les attributs d’objet pour l’objet de clé de Registre framework. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[out] Key

Pointeur vers un emplacement qui reçoit un handle vers un objet de clé de Registre d’infrastructure.

Valeur retournée

Reportez-vous à WdfDriverOpenParametersRegistryKey.

Remarques

La Parameters clé concerne les paramètres immuables fournis dans le fichier INF. Pour accéder à ces paramètres, utilisez WdfDriverOpenParametersRegistryKey. La clé retournée par cette API concerne les paramètres écrits au moment de l’exécution.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
Version KMDF minimale	1,25
Version UMDF minimale	2.25
En-tête	wdfdriver.h
IRQL	PASSIVE_LEVEL

Voir aussi

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE