WdfDriverGetRegistryPath 함수(wdfdriver.h)
[KMDF 및 UMDF에 적용]
WdfDriverGetRegistryPath 메서드는 레지스트리의 서비스 트리에서 드라이버의 레지스트리 키에 대한 경로를 검색합니다.
구문
PWSTR WdfDriverGetRegistryPath(
[in] WDFDRIVER Driver
);
매개 변수
[in] Driver
WdfDriverCreate 또는 WdfGetDriver에 대한 이전 호출에서 가져온 드라이버의 프레임워크 드라이버 개체에 대한 핸들입니다.
반환 값
WdfDriverGetRegistryPath 는 드라이버의 레지스트리 경로를 나타내는 NULL로 끝나는 유니코드 문자열에 대한 포인터를 반환합니다. 드라이버 핸들이 잘못된 경우 시스템 버그 검사 발생합니다.
설명
WdfDriverGetRegistryPath가 반환하는 레지스트리 경로 문자열은 드라이버가 DriverEntry 루틴에 대한 입력으로 받은 UNICODE_STRING 구조에서 가져옵니다.
레지스트리에 대한 자세한 내용은 Framework-Based 드라이버에서 레지스트리 사용을 참조하세요.
예제
다음 코드 예제에서는 레지스트리의 서비스 트리에서 드라이버의 레지스트리 키에 대한 경로를 가져옵니다 .
PWSTR registryPath;
registryPath = WdfDriverGetRegistryPath(driver);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfdriver.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |