WdfDriverOpenPersistentStateRegistryKey 함수(wdfdriver.h)
드라이버는 WdfDriverOpenPersistentStateRegistryKey 를 사용하여 드라이버 전체 영구 정보를 레지스트리에 작성해야 합니다.
구문
NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
[in] WDFDRIVER Driver,
[in] ACCESS_MASK DesiredAccess,
[in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
[out] WDFKEY *Key
);
매개 변수
[in] Driver
드라이버가 WdfDriverCreate 또는 WdfGetDriver 에 대한 이전 호출에서 가져온 드라이버의 프레임워크 드라이버 개체 에 대한 핸들입니다.
[in] DesiredAccess
레지스트리 키에 대한 액세스 마스크를 지정하는 ACCESS_MASK 형식화된 값입니다. KMDF 드라이버는 일반적으로 KEY_READ, KEY_WRITE 또는 KEY_READKEY_WRITE | 요청합니다. UMDF 드라이버를 작성하는 경우 KEY_READ 사용하거나 KEY_SET_VALUE KEY_READ | . 모범 사례로 드라이버에 필요한 액세스 유형만 요청합니다.
[in, optional] KeyAttributes
프레임워크 레지스트리 키 개체의 개체 특성을 지정하는 호출자가 할당한 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.
[out] Key
프레임워크 레지스트리 키 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다.
반환 값
WdfDriverOpenParametersRegistryKey를 참조하세요.
설명
키는 Parameters INF 파일에 제공된 변경할 수 없는 설정에 대한 것입니다. 이러한 설정에 액세스하려면 WdfDriverOpenParametersRegistryKey를 사용합니다. 이 API에서 반환된 키는 런타임에 작성된 설정에 대한 것입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10, 버전 1803 |
| 최소 KMDF 버전 | 1.25 |
| 최소 UMDF 버전 | 2.25 |
| 머리글 | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |