Fungsi SetupDiGetDeviceInstanceIdA (setupapi.h)

Artikel
08/26/2023

Fungsi SetupDiGetDeviceInstanceId mengambil ID instans perangkat yang terkait dengan elemen informasi perangkat.

Catatan

Di Windows Vista dan versi Windows yang lebih baru, model properti perangkat terpadu menggunakan kunci properti DEVPKEY_Device_InstanceId untuk mewakili pengidentifikasi instans perangkat. Lihat Mengambil Pengidentifikasi Instans Perangkat untuk detailnya.

Sintaks

WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PSTR             DeviceInstanceId,
  [in]            DWORD            DeviceInstanceIdSize,
  [out, optional] PDWORD           RequiredSize
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk mengambil ID instans perangkat.

[in] DeviceInfoData

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

[out, optional] DeviceInstanceId

Penunjuk ke buffer karakter yang akan menerima ID instans perangkat yang dihentikan NULL untuk elemen informasi perangkat yang ditentukan. Untuk informasi tentang ID instans perangkat, lihat String Identifikasi Perangkat.

[in] DeviceInstanceIdSize

Ukuran, dalam karakter, dari buffer DeviceInstanceId .

[out, optional] RequiredSize

Penunjuk ke variabel yang menerima jumlah karakter yang diperlukan untuk menyimpan ID instans perangkat.

Menampilkan nilai

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

Keterangan

Catatan

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


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

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo

Bagikan melalui