Fungsi SetupDiGetDeviceInstanceIdA (setupapi.h)

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

Nota

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.

Sintaksis

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 set informasi perangkat yang diatur 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.

Mengembalikan nilai

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

Komentar

Nota

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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo