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

추가 정보

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE