Fonction IoOpenDriverRegistryKey (wdm.h)
La routine IoOpenDriverRegistryKey retourne un handle à une clé de Registre spécifique au pilote pour un pilote particulier.
Syntaxe
NTSTATUS IoOpenDriverRegistryKey(
[in] PDRIVER_OBJECT DriverObject,
[in] DRIVER_REGKEY_TYPE RegKeyType,
[in] ACCESS_MASK DesiredAccess,
[in] ULONG Flags,
[out] PHANDLE DriverRegKey
);
Paramètres
[in] DriverObject
Pointeur vers une structure DRIVER_OBJECT. Cette structure doit être l’objet de pilote pour le pilote appelant.
[in] RegKeyType
Énumération de type DRIVER_REGKEY_TYPE qui indique le type de la clé de Registre demandée.
[in] DesiredAccess
Spécifie la valeur ACCESS_MASK qui représente les droits d’accès nécessaires à la clé. Consultez ZwCreateKey pour obtenir une description de chaque droit d’accès KEY_XXX.
[in] Flags
Défini sur zéro.
[out] DriverRegKey
Pointeur vers la variable HANDLE qui, lors d’un retour réussi, contient un handle vers la clé de Registre demandée.
Valeur de retour
IoOpenDriverRegistryKey retourne STATUS_SUCCESS si l’appel a correctement ouvert un handle à la clé de Registre demandée.
Remarques
Le pilote doit appeler ZwClose pour fermer le handle retourné par cette routine lorsque l’accès n’est plus nécessaire.
Les clés de Registre ouvertes par cette routine ne sont pasvolatiles.
Pour approvisionner des clés et des valeurs sous la DriverRegKeyParameters clé de Registre, utilisez une directive AddReg à partir d’une section service-install-section pour référencer une section add-registry-section qui contient des entrées avec une racine régulière de HKR et une sous-clé de Parameters.
Les appelants de IoOpenDriverRegistryKey doivent s’exécuter à IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1803 |
| d’en-tête | wdm.h (include wdm.h, ntddk.h ou ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |