fungsi CM_Get_DevNode_PropertyW (cfgmgr32.h)

Artikel
08/22/2023

Fungsi CM_Get_DevNode_Property mengambil properti instans perangkat.

Sintaks

CMAPI CONFIGRET CM_Get_DevNode_PropertyW(
  [in]      DEVINST          dnDevInst,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Parameter

[in] dnDevInst

Handel instans perangkat yang terikat ke komputer lokal.

[in] PropertyKey

Arahkan ke struktur DEVPROPKEY yang mewakili kunci properti perangkat dari properti instans perangkat yang diminta.

[out] PropertyType

Penunjuk ke variabel berjenis DEVPROPTYPE yang menerima pengidentifikasi tipe data properti dari properti instans perangkat yang diminta, di mana pengidentifikasi tipe data properti adalah bitwise ATAU antara pengidentifikasi jenis data dasar dan, jika jenis data dasar dimodifikasi, pengubah tipe data properti.

[out] PropertyBuffer

Penunjuk ke buffer yang menerima properti instans perangkat yang diminta. CM_Get_DevNode_Property mengambil properti yang diminta hanya jika buffer cukup besar untuk menyimpan semua data nilai properti. Penunjuk bisa NULL.

[in, out] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer . Jika PropertyBuffer diatur ke NULL, *PropertyBufferSize harus diatur ke nol. Sebagai output, jika buffer tidak cukup besar untuk menyimpan semua data nilai properti, CM_Get_DevNode_Property mengembalikan ukuran data, dalam byte, di *PropertyBufferSize.

[in] ulFlags

Dicadangkan. Harus diatur ke nol.

Nilai kembali

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, kode kesalahan mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

CM_Get_DevNode_Property adalah bagian dari Model Properti Perangkat Terpadu.

Persyaratan


Klien minimum yang didukung	Tersedia di Microsoft Windows Vista dan versi Windows yang lebih baru.
Target Platform	Universal
Header	cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka	Cfgmgr32.lib
DLL	CfgMgr32.dll

Lihat juga

SetupDiGetDeviceProperty

Bagikan melalui