Функция 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 драйверах.

Примеры

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

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Требования