WdfRegistryWdmGetHandle 함수(wdfregistry.h)

[KMDF 및 UMDF에 적용]

WdfRegistryWdmGetHandle 메서드는 지정된 프레임워크 레지스트리 키 개체가 나타내는 레지스트리 키에 WDM(Windows 드라이버 모델) 핸들을 반환합니다.

구문

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

매개 변수

[in] Key

열린 레지스트리 키를 나타내는 레지스트리 키 개체에 대한 핸들입니다.

반환 값

WdfRegistryWdmGetHandle 은 레지스트리 키에 WDM 핸들을 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

KMDF 드라이버는 반환된 WDM 핸들을 입력으로 허용하는 ZwXxx 루틴 에 전달할 수 있습니다.

UMDF 드라이버는 반환된 핸들을 RegEnumKeyEx와 같은 HKEY가 필요한 API에 전달할 수 있습니다.

WdfRegistryWdmGetHandle 메서드가 반환하는 핸들은 레지스트리 키 개체가 삭제될 때까지 유효합니다. 드라이버가 레지스트리 키 개체에 대해 EvtCleanupCallback 함수를 제공하는 경우 콜백 함수가 반환될 때까지 포인터가 유효합니다.

레지스트리 키 개체에 대한 자세한 내용은 Framework-Based 드라이버에서 레지스트리 사용을 참조하세요.

예제

다음 코드 예제에서는 지정된 프레임워크 레지스트리 키 개체가 나타내는 레지스트리 키에 대한 WDM 핸들을 가져옵니다.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

요구 사항