Bagikan melalui

Fungsi SetupDiSetDeviceRegistryPropertyA (setupapi.h)

  • Artikel

Fungsi SetupDiSetDeviceRegistryProperty mengatur properti perangkat Plug and Play untuk perangkat.

Sintaks

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 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