Bagikan melalui

Fungsi SetupDiSetDeviceRegistryPropertyA (setupapi.h)

Fungsi SetupDiSetDeviceRegistryProperty mengatur properti perangkat Plug and Play untuk perangkat.

Sintaksis

WINSETUPAPI BOOL SetupDiSetDeviceRegistryPropertyA(
  [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 set informasi perangkat yang diatur 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 saat 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

Nota

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, penunjuk ini harus NULL dan PropertyBufferSize harus nol.

[in] PropertyBufferSize

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

Mengembalikan nilai

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

Komentar

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.

Nota

Header setupapi.h mendefinisikan SetupDiSetDeviceRegistryProperty sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor 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

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

Lihat juga

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

  • Last updated on