Metode IWDFDevice::RetrieveDevicePropertyStore (wudfddi.h)

Artikel
02/27/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode RetrieveDevicePropertyStore mengambil antarmuka penyimpanan properti yang dapat digunakan driver untuk mengakses registri.

Sintaks

HRESULT RetrieveDevicePropertyStore(
  [in, optional]  PCWSTR                            pcwszServiceName,
  [in]            WDF_PROPERTY_STORE_RETRIEVE_FLAGS Flags,
  [out]           IWDFNamedPropertyStore            **ppPropStore,
  [out, optional] WDF_PROPERTY_STORE_DISPOSITION    *pDisposition
);

Parameter

[in, optional] pcwszServiceName

Penunjuk ke string yang dihentikan NULL yang mewakili nama penyimpanan properti perangkat. Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak memberikan nama untuk penyimpanan properti perangkat.

[in] Flags

Nilai yang WDF_PROPERTY_STORE_RETRIEVE_FLAGS ketik yang mengidentifikasi cara mengambil penyimpanan properti perangkat.

[out] ppPropStore

Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFNamedPropertyStore . Driver menggunakan antarmuka ini untuk mengakses nilai dalam registri.

[out, optional] pDisposition

Pointer ke variabel yang menerima nilai WDF_PROPERTY_STORE_DISPOSITION-typed yang mengidentifikasi apakah kerangka kerja membuat penyimpanan properti perangkat atau penyimpanan properti perangkat sudah ada. Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak memerlukan informasi disposisi.

Mengembalikan nilai

RetrieveDevicePropertyStore mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h.

Keterangan

Pemanggil harus memanggil metode Rilis antarmuka IWDFNamedPropertyStore setelah selesai dengan penyimpanan properti.

Untuk informasi selengkapnya, lihat Menggunakan Registri di Driver berbasis UMDF.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll