Метод IWDFDevice::RetrieveDevicePropertyStore (wudfddi.h)

Статья
02/07/2025

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод RetrieveDevicePropertyStore извлекает интерфейс хранилища свойств, который драйверы могут использовать для доступа к реестру.

Синтаксис

HRESULT RetrieveDevicePropertyStore(
  [in, optional]  PCWSTR                            pcwszServiceName,
  [in]            WDF_PROPERTY_STORE_RETRIEVE_FLAGS Flags,
  [out]           IWDFNamedPropertyStore            **ppPropStore,
  [out, optional] WDF_PROPERTY_STORE_DISPOSITION    *pDisposition
);

Параметры

[in, optional] pcwszServiceName

Указатель на строку NULL-terminated, представляющую имя хранилища свойств устройства. Этот параметр является необязательным. Драйвер может передать NULL, если драйвер не предоставляет имя для хранилища свойств устройства.

[in] Flags

Значение WDF_PROPERTY_STORE_RETRIEVE_FLAGSтипа, определяющее, как получить хранилище свойств устройства.

[out] ppPropStore

Указатель на буфер, который получает указатель на интерфейс IWDFNamedPropertyStore. Драйвер использует этот интерфейс для доступа к значениям в реестре.

[out, optional] pDisposition

Указатель на переменную, получающую WDF_PROPERTY_STORE_DISPOSITIONтипизированное значение, определяющее, создана ли платформа хранилища свойств устройства или хранилища свойств устройства уже существует. Этот параметр является необязательным. Драйвер может передать NULL, если драйвер не требует сведений о ликвидации.

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

RetrieveDevicePropertyStore возвращает S_OK, если операция завершится успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Замечания

Вызывающий объект должен вызывать метод выпуска интерфейса IWDFNamedPropertyStore после завершения работы с хранилищем свойств.

Дополнительные сведения см. в разделе Использование реестра в драйверах на основе UMDF.

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.5
заголовка	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll