IWDFDeviceInitialize：：RetrieveDevicePropertyStore 方法 (wudfddi.h)
[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，且較新版本的 Windows 10 上不支援 UMDF 1。 通用 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 中定義的其中一個錯誤碼。
備註
呼叫端應該在屬性存放區完成之後，呼叫 IWDFNamedPropertyStore 介面的 Release 方法。
如需詳細資訊，請參閱 在 UMDF 型驅動程式中使用登錄。
規格需求
| 需求 | 值 |
|---|---|
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.5 |
| 標頭 | wudfddi.h (包括 Wudfddi.h) |
| Dll | WUDFx.dll |