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

Драйверы должны использовать 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, предназначен для параметров, записанных во время выполнения.

Требования

См. также раздел

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE