Fungsi SetupDiSetDeviceRegistryPropertyW (setupapi.h)

Artikel
03/01/2024

Fungsi SetupDiSetDeviceRegistryProperty mengatur properti perangkat Plug and Play untuk perangkat.

Sintaks

WINSETUPAPI BOOL SetupDiSetDeviceRegistryPropertyW(
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData,
  [in]           DWORD            Property,
  [in, optional] const BYTE       *PropertyBuffer,
  [in]           DWORD            PropertyBufferSize
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk mengatur properti perangkat Plug and Play.

[in, out] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Jika properti ClassGuid diatur, DeviceInfoData.ClassGuid diatur setelah kembali ke kelas baru untuk perangkat.

[in] Property

Salah satu nilai berikut, yang mengidentifikasi properti yang akan diatur. Untuk deskripsi nilai-nilai ini, lihat SetupDiGetDeviceRegistryProperty.

SPDRP_CONFIGFLAGS
SPDRP_EXCLUSIVE
SPDRP_FRIENDLYNAME
SPDRP_LOCATION_INFORMATION
SPDRP_LOWERFILTERS
SPDRP_REMOVAL_POLICY_OVERRIDE
SPDRP_SECURITY
SPDRP_SECURITY_SDS
SPDRP_UI_NUMBER_DESC_FORMAT
SPDRP_UPPERFILTERS

Catatan

SPDRP_HARDWAREID atau SPDRP_COMPATIBLEIDS hanya dapat digunakan saat DeviceInfoData mewakili perangkat yang dijumlahkan akar. Untuk perangkat lain, driver bus melaporkan perangkat keras dan ID yang kompatibel saat menghitung perangkat anak setelah menerima IRP_MN_QUERY_ID.

Nilai berikut dicadangkan untuk digunakan oleh sistem operasi dan tidak dapat digunakan dalam parameter Properti :

SPDRP_ADDRESS
SPDRP_BUSNUMBER
SPDRP_BUSTYPEGUID
SPDRP_CHARACTERISTICS
SPDRP_CAPABILITIES
SPDRP_CLASS
SPDRP_CLASSGUID
SPDRP_DEVICE_POWER_DATA
SPDRP_DEVICEDESC
SPDRP_DEVTYPE
SPDRP_DRIVER
SPDRP_ENUMERATOR_NAME
SPDRP_INSTALL_STATE
SPDRP_LEGACYBUSTYPE
SPDRP_LOCATION_PATHS
SPDRP_MFG
SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
SPDRP_REMOVAL_POLICY
SPDRP_REMOVAL_POLICY_HW_DEFAULT
SPDRP_SERVICE
SPDRP_UI_NUMBER

[in, optional] PropertyBuffer

Penunjuk ke buffer yang berisi data baru untuk properti . Jika properti sedang dibersihkan, maka pointer ini harus NULL dan PropertyBufferSize harus nol.

[in] PropertyBufferSize

Ukuran, dalam byte, dari PropertyBuffer. Jika PropertyBufferADALAH NULL, maka bidang ini harus nol.

Nilai kembali

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Keterangan

Pemanggil fungsi ini harus menjadi anggota grup Administrator.

Properti nama kelas tidak dapat diatur karena didasarkan pada GUID kelas yang sesuai dan secara otomatis diperbarui ketika properti tersebut diubah. Saat properti ClassGUID berubah, SetupDiSetDeviceRegistryProperty secara otomatis membersihkan kunci perangkat lunak apa pun yang terkait dengan perangkat.

Catatan

Header setupapi.h mendefinisikan SetupDiSetDeviceRegistryProperty sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

Bagikan melalui