IWDFDevice：：RetrieveDevicePropertyStore 方法（wudfddi.h）

發行項
02/07/2025

[警告： 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