Metode IWDFDeviceInitialize::RetrieveDevicePropertyStore (wudfddi.h)
[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 penyimpanan properti perangkat yang dapat dibaca dan ditulis klien properti perangkat.
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 menyediakan nama untuk penyimpanan properti perangkat.
[in] Flags
Nilai berjenis WDF_PROPERTY_STORE_RETRIEVE_FLAGS yang mengidentifikasi cara mengambil penyimpanan properti perangkat.
[out] ppPropStore
Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFNamedPropertyStore yang digunakan untuk mengambil properti perangkat.
[out, optional] pDisposition
Penunjuk ke variabel yang menerima nilai jenis WDF_PROPERTY_STORE_DISPOSITION yang mengidentifikasi apakah kerangka kerja yang 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 ditentukan 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 |