Partager via

Fonction IoOpenDriverRegistryKey (wdm.h)

  • Article

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

Voir aussi

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE