Fungsi SetupDiSetDevicePropertyW (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiSetDeviceProperty mengatur properti instans perangkat.

Sintaks

WINSETUPAPI BOOL SetupDiSetDevicePropertyW(
  [in]           HDEVINFO         DeviceInfoSet,
  [in]           PSP_DEVINFO_DATA DeviceInfoData,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in, optional] const PBYTE      PropertyBuffer,
  [in]           DWORD            PropertyBufferSize,
  [in]           DWORD            Flags
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat. Kumpulan informasi perangkat ini berisi elemen informasi perangkat yang mewakili instans perangkat untuk mengatur properti instans perangkat.

[in] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang mengidentifikasi instans perangkat untuk mengatur properti instans perangkat.

[in] PropertyKey

Penunjuk ke struktur DEVPROPKEY yang mewakili kunci properti perangkat dari properti instans perangkat untuk diatur.

[in] PropertyType

Nilai berjenis DEVPROPTYPE yang mewakili pengidentifikasi tipe data properti untuk properti instans perangkat. Untuk informasi selengkapnya, lihat bagian Keterangan nanti dalam topik ini.

[in, optional] PropertyBuffer

Penunjuk ke buffer yang berisi nilai properti instans perangkat. Jika properti sedang dihapus atau diatur ke nilai NULL , pointer ini harus NULL, dan PropertyBufferSize harus diatur ke nol.

[in] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer . Jika PropertyBuffer ADALAH NULL, PropertyBufferSize harus diatur ke nol.

[in] Flags

Parameter ini harus diatur ke nol.

Menampilkan nilai

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

Tabel berikut ini menyertakan beberapa kode kesalahan yang lebih umum yang mungkin dicatat fungsi ini.

Menampilkan kode	Deskripsi
ERROR_INVALID_FLAGS	Nilai Bendera bukan nol.
ERROR_INVALID_HANDLE	Kumpulan informasi perangkat yang ditentukan oleh DevInfoSet tidak valid.
ERROR_INVALID_PARAMETER	Parameter yang disediakan tidak valid. Salah satu kemungkinannya adalah bahwa elemen informasi perangkat tidak valid.
ERROR_INVALID_REG_PROPERTY	Kunci properti yang disediakan oleh PropertyKey tidak valid atau properti tidak dapat ditulis.
ERROR_INVALID_DATA	Pengidentifikasi tipe data properti yang disediakan oleh PropertyType, atau nilai properti yang disediakan oleh PropertyBuffer, tidak valid.
ERROR_INVALID_USER_BUFFER	Buffer pengguna tidak valid. Salah satu kemungkinan adalah bahwa PropertyBuffer adalah NULL, dan PropertyBufferSize bukan nol.
ERROR_NO_SUCH_DEVINST	Instans perangkat yang ditentukan oleh DevInfoData tidak ada.
ERROR_INSUFFICIENT_BUFFER	Buffer data internal yang diteruskan ke panggilan sistem terlalu kecil.
ERROR_NOT_ENOUGH_MEMORY	Tidak tersedia cukup memori sistem untuk menyelesaikan operasi.
ERROR_NOT_FOUND	Elemen internal yang tidak ditentukan tidak ditemukan. Salah satu kemungkinan adalah bahwa properti yang akan dihapus tidak ada.
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki hak istimewa Administrator.

Keterangan

SetupDiSetDeviceProperty adalah bagian dari model properti perangkat terpadu.

SetupAPI hanya mendukung versi Unicode SetupDiSetDeviceProperty.

Penelepon SetupDiSetDeviceProperty harus menjadi anggota grup Administrator untuk mengatur properti instans perangkat.

SetupDiSetDeviceProperty memberlakukan persyaratan pada pengidentifikasi jenis data properti dan nilai properti.

Untuk mendapatkan kunci properti perangkat untuk properti perangkat instans yang diatur untuk perangkat, panggil SetupDiGetDevicePropertyKeys.

Untuk mengambil properti instans perangkat, panggil SetupDiGetDeviceProperty.

Persyaratan


Klien minimum yang didukung	Tersedia di Windows Vista dan versi Windows yang lebih baru.
Target Platform	DesktopUntuk universal, panggil CM_Set_DevNode_Property
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetDeviceProperty

SetupDiGetDevicePropertyKeys

Bagikan melalui