IoOpenDriverRegistryKey 函式 (wdm.h)
IoOpenDriverRegistryKey 例程會傳回特定驅動程式之驅動程式特定登錄機碼的句柄。
語法
NTSTATUS IoOpenDriverRegistryKey(
[in] PDRIVER_OBJECT DriverObject,
[in] DRIVER_REGKEY_TYPE RegKeyType,
[in] ACCESS_MASK DesiredAccess,
[in] ULONG Flags,
[out] PHANDLE DriverRegKey
);
參數
[in] DriverObject
DRIVER_OBJECT 結構的指標。 這個結構必須是呼叫驅動程序的驅動程序物件。
[in] RegKeyType
型 別的列舉DRIVER_REGKEY_TYPE ，表示所要求登錄機碼的類型。
[in] DesiredAccess
指定 ACCESS_MASK 值，表示金鑰所需的訪問許可權。 如需每個KEY_XXX訪問許可權的描述，請參閱 ZwCreateKey 。
[in] Flags
設定為零。
[out] DriverRegKey
在成功傳回時，HANDLE 變數的指標包含要求的登錄機碼句柄。
傳回值
如果呼叫成功開啟要求的登錄機碼句柄，IoOpenDriverRegistryKey 會傳回STATUS_SUCCESS。
備註
驅動程式必須呼叫 ZwClose ，才能在不再需要存取時關閉從這個例程傳回的句柄。
此例程所開啟的登錄機碼為非volatile。
若要在不可變的 DriverRegKeyParameters 登錄機碼下布建機碼和值，請使用 service-install-section 的 AddReg 指示詞來參考 add-registry-section 區段，其中包含具有 reg-root 的專案HKR，以及 的Parameters子機碼。
IoOpenDriverRegistryKey 的呼叫端必須在 IRQL = PASSIVE_LEVEL系統線程的內容中執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 (版本 1803) |
| 標頭 | wdm.h (包括 wdm.h、ntddk.h 或 ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |