Функция WdfRegistryWdmGetHandle (wdfregistry.h)

  • Статья

[Относится к KMDF и UMDF]

Метод WdfRegistryWdmGetHandle возвращает дескриптор модели драйвера Windows (WDM) в раздел реестра, который представляет указанный объект реестра платформы.

Синтаксис

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Параметры

[in] Key

Дескриптор для объекта раздела реестра, представляющего открытый раздел реестра.

Возвращаемое значение

WdfRegistryWdmGetHandle возвращает дескриптор WDM в раздел реестра.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Драйвер KMDF может передать возвращенный дескриптор WDM подпрограммам ZwXxx, которые принимают дескриптор WDM в качестве входных данных.

Драйвер UMDF может передать возвращенный дескриптор API, для которых требуется ключ HKEY, например RegEnumKeyEx.

Дескриптор, возвращаемый методом WdfRegistryWdmGetHandle , действителен до тех пор, пока объект раздела реестра не будет удален. Если драйвер предоставляет функцию EvtCleanupCallback для объекта раздела реестра, указатель будет действителен до тех пор, пока функция обратного вызова не вернет.

Дополнительные сведения об объектах раздела реестра см. в статье Использование реестра в Framework-Based Drivers.

Примеры

В следующем примере кода получается дескриптор WDM для раздела реестра, который представляет указанный объект реестра платформы.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfregistry.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Правила соответствия DDI DriverCreate(kmdf)