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

Статья
08/08/2023

[Предупреждение: 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, представляющую имя хранилища свойств устройства. Этот параметр является необязательным. Драйвер может передать значение NULL , если драйвер не предоставляет имя для хранилища свойств устройства.

[in] Flags

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

[out] ppPropStore

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

[out, optional] pDisposition

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

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

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

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll