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
0으로 설정됩니다.
[out] DriverRegKey
반환이 성공적일 때 요청된 레지스트리 키에 대한 핸들을 포함하는 HANDLE 변수에 대한 포인터입니다.
반환 값
IoOpenDriverRegistryKey 는 호출이 요청된 레지스트리 키에 대한 핸들을 성공적으로 열면 STATUS_SUCCESS 반환합니다.
설명
드라이버는 ZwClose 를 호출하여 액세스가 더 이상 필요하지 않은 경우 이 루틴에서 반환된 핸들을 닫아야 합니다.
이 루틴에서 연 레지스트리 키는 비휘발성 키입니다.
변경할 수 없는 DriverRegKeyParameters 레지스트리 키 아래에 키와 값을 프로비전하려면 service-install-section의 AddReg 지시문을 사용하여 의 reg-root HKR 및 하위 키가 Parameters있는 항목이 포함된 add-registry-section 섹션을 참조합니다.
IoOpenDriverRegistryKey의 호출자는 시스템 스레드의 컨텍스트에서 IRQL = PASSIVE_LEVEL 실행되어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10, 버전 1803 |
| 머리글 | wdm.h(wdm.h, ntddk.h 또는 ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |