Fungsi SwDevicePropertySet (swdevice.h)

Artikel
05/03/2024

Mengatur properti pada perangkat lunak.

Sintaks

HRESULT SwDevicePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

Parameter

[in] hSwDevice

HSWDEVICE menangani ke perangkat perangkat lunak untuk mengatur properti.

[in] cPropertyCount

Jumlah struktur DEVPROPERTY dalam array pProperties .

[in] pProperties

Array struktur DEVPROPERTY yang berisi properti yang akan diatur.

Mengembalikan nilai

S_OK dikembalikan jika SwDevicePropertySet berhasil mengatur properti; jika tidak, nilai kesalahan yang sesuai.

Keterangan

Anda dapat memanggil SwDevicePropertySet hanya setelah sistem operasi memanggil fungsi panggilan balik SW_DEVICE_CREATE_CALLBACK aplikasi klien Anda untuk memberi tahu aplikasi klien bahwa enumerasi perangkat selesai.

Ada perbedaan halus antara properti yang ditetapkan sebagai bagian dari panggilan dan properti SwDeviceCreate yang kemudian diatur dengan memanggil SwDevicePropertySet. Properti yang ditetapkan sebagai bagian dari SwDeviceCreate disimpan dalam memori; jika perangkat dihapus instalannya atau driver null menghapus penyimpanan properti, properti ini ditulis lagi oleh fitur API Perangkat Lunak saat PnP menghitung ulang perangkat. Ini semua transparan untuk klien. Properti yang diatur menggunakan SwDevicePropertySet setelah enumerasi tidak bertahan dalam memori. Tetapi, jika Anda mengatur properti dengan menggunakan SwDeviceCreate, Anda dapat memperbarui nilai dengan SwDevicePropertySet, dan pembaruan ini diterapkan ke nilai dalam memori serta penyimpanan yang bertahan.

Anda dapat menggunakan SwDevicePropertySet hanya untuk mengatur properti di penyimpanan sistem operasi untuk perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Universal
Header	swdevice.h
Pustaka	Swdevice.lib; OneCoreUAP.lib di Windows 10
DLL	Cfgmgr32.dll

Bagikan melalui