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


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

[Предупреждение: 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.

Комментарии

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

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

Требования

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

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

IWDFDevice

IWDFDeviceInitialize::RetrieveDevicePropertyStore

IWDFNamedPropertyStore

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore

WDF_PROPERTY_STORE_DISPOSITION

WDF_PROPERTY_STORE_RETRIEVE_FLAGS