Метод IWDFDeviceInitialize::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 |