Функция WdfDriverOpenPersistentStateRegistryKey (wdfdriver.h)

Статья
08/08/2023

Драйверы должны использовать 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_READ | KEY_WRITE. Если вы пишете драйвер UMDF, используйте KEY_READ или KEY_READ | KEY_SET_VALUE. Рекомендуется запрашивать только те типы доступа, которые необходимы вашему драйверу.

[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

Поделиться через