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 |