Fungsi SetupDiGetCustomDevicePropertyA (setupapi.h)

Fungsi SetupDiGetCustomDeviceProperty mengambil properti perangkat kustom tertentu dari registri.

Sintaksis

WINSETUPAPI BOOL SetupDiGetCustomDevicePropertyA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [in]            PCSTR            CustomPropertyName,
  [in]            DWORD            Flags,
  [out, optional] PDWORD           PropertyRegDataType,
  [out]           PBYTE            PropertyBuffer,
  [in]            DWORD            PropertyBufferSize,
  [out, optional] PDWORD           RequiredSize
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk mengambil properti perangkat kustom.

[in] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet.

[in] CustomPropertyName

Nama nilai registri yang mewakili properti kustom.

[in] Flags

Nilai bendera yang menunjukkan bagaimana informasi yang diminta harus dikembalikan. Bendera bisa nol atau salah satu dari berikut ini:

DICUSTOMDEVPROP_MERGE_MULTISZ

Jika diatur, fungsi mengambil nilai properti khusus instans perangkat dan nilai properti khusus ID perangkat keras, yang digabungkan sebagai string yang ditik REG_MULTI_SZ. (Untuk informasi selengkapnya, lihat bagian Keterangan di halaman referensi ini.)

[out, optional] PropertyRegDataType

Pointer ke variabel jenis DWORD yang menerima jenis data properti yang diambil. Jenis data ditentukan sebagai salah satu konstanta awalan REG_ yang mewakili jenis data registri. Parameter ini bersifat opsional dan dapat NULL.

[out] PropertyBuffer

Penunjuk ke buffer yang menerima informasi properti yang diminta.

[in] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer.

[out, optional] RequiredSize

Penunjuk ke variabel jenis DWORD yang menerima ukuran buffer, dalam byte, yang diperlukan untuk menerima informasi yang diminta. Parameter ini bersifat opsional dan dapat NULL. Jika parameter ini ditentukan, SetupDiGetCustomDeviceProperty mengembalikan ukuran yang diperlukan, terlepas dari apakah PropertyBuffer buffer cukup besar untuk menerima informasi yang diminta.

Mengembalikan nilai

Jika operasi berhasil, SetupDiGetCustomDeviceProperty mengembalikan TRUE. Jika tidak, fungsi mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError. Jika buffer PropertyBuffer tidak cukup besar untuk menerima informasi yang diminta, SetupDiGetCustomDeviceProperty mengembalikan FALSE dan panggilan berikutnya ke GetLastError akan mengembalikan ERROR_INSUFFICIENT_BUFFER.

Komentar

SetupDiGetCustomDeviceProperty mengambil properti perangkat yang terkait dengan satu instans perangkat atau dengan semua perangkat yang cocok dengan ID perangkat keras tertentu. (Untuk informasi tentang ID perangkat keras, lihat String Identifikasi Perangkat).

Vendor dapat mengatur properti untuk instans perangkat dengan menggunakan direktif INF AddReg di bagian INF DDInstall.HW dan menentukan akar registri HKR .

Hanya sistem yang dapat mengatur properti untuk ID perangkat keras. Sistem menyediakan properti "Ikon" untuk beberapa ID perangkat keras.

Fungsi pertama-tama memeriksa untuk melihat apakah properti yang ditentukan ada untuk instans perangkat yang ditentukan. Jika demikian, nilai properti dikembalikan. Jika tidak, fungsi memeriksa untuk melihat apakah properti ada untuk semua perangkat yang cocok dengan ID perangkat keras dari instans perangkat yang ditentukan. Jika demikian, nilai properti dikembalikan. Jika DICUSTOMDEVPROP_MERGE_MULTISZ diatur dalam Flags, fungsi mengembalikan nilai properti yang terkait dengan instans perangkat dan ID perangkat keras, jika keduanya ada.

Nota

Header setupapi.h mendefinisikan SetupDiGetCustomDeviceProperty 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 Windows XP dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib
DLL	Setupapi.dll

Lihat juga

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiOpenDevRegKey

SetupDiSetClassRegistryProperty

SetupDiSetDeviceRegistryProperty