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 pilote du 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 pour la clé. Pour obtenir une description de chaque droit d’accès KEY_XXX, consultez ZwCreateKey .
[in] Flags
Définit la valeur zéro.
[out] DriverRegKey
Pointeur vers la variable HANDLE qui, en cas de retour réussi, contient un handle vers la clé de Registre demandée.
Valeur retournée
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 pas volatiles.
Pour approvisionner des clés et des valeurs sous la clé de Registre DriverRegKeyParameters immuable, utilisez une directive AddReg d’une section d’installation de service pour référencer une section add-registry-section qui contient des entrées avec une racine HKR reg et une sous-clé de Parameters.
Les appelants d’IoOpenDriverRegistryKey doivent s’exécuter à IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 version 1803 |
| En-tête | wdm.h (inclure wdm.h, ntddk.h ou ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |