Функция 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