IoOpenDriverRegistryKey function (wdm.h)
The IoOpenDriverRegistryKey routine returns a handle to a driver-specific registry key for a particular driver.
NTSTATUS IoOpenDriverRegistryKey( [in] PDRIVER_OBJECT DriverObject, [in] DRIVER_REGKEY_TYPE RegKeyType, [in] ACCESS_MASK DesiredAccess, [in] ULONG Flags, [out] PHANDLE DriverRegKey );
A pointer to a DRIVER_OBJECT structure. This structure must be the driver object for the calling driver.
An enumeration of type DRIVER_REGKEY_TYPE that indicates the type of the requested registry key.
Specifies the ACCESS_MASK value that represents the access rights needed for the key. See ZwCreateKey for a description of each KEY_XXX access right.
Set to zero.
A pointer to the HANDLE variable that, on successful return, contains a handle to the requested registry key.
IoOpenDriverRegistryKey returns STATUS_SUCCESS if the call successfully opened a handle to the requested registry key.
The driver must call ZwClose to close the handle returned from this routine when access is no longer needed.
The registry keys opened by this routine are nonvolatile.
To provision keys and values under the immutable DriverRegKeyParameters registry key, use an AddReg directive from a service-install-section to reference an add-registry-section section that contains entries with a reg-root of
HKR and a subkey of
Callers of IoOpenDriverRegistryKey must be running at IRQL = PASSIVE_LEVEL in the context of a system thread.
|Minimum supported client||Windows 10, version 1803|
|Header||wdm.h (include wdm.h, ntddk.h, or ntifs.h)|
Submit and view feedback for