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

추가 정보

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE