SetupDiGetDeviceInterfacePropertyKeys (setupapi.h)

Fungsi SetupDiGetDeviceInterfacePropertyKeys mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk antarmuka perangkat.

Sintaks

WINSETUPAPI BOOL SetupDiGetDeviceInterfacePropertyKeys(
  [in]            HDEVINFO                  DeviceInfoSet,
  [in]            PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [out, optional] DEVPROPKEY                *PropertyKeyArray,
  [in]            DWORD                     PropertyKeyCount,
  [out, optional] PDWORD                    RequiredPropertyKeyCount,
  [in]            DWORD                     Flags
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat. Kumpulan informasi perangkat ini berisi antarmuka perangkat untuk mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk antarmuka perangkat.

[in] DeviceInterfaceData

Penunjuk ke struktur SP_DEVICE_INTERFACE_DATA yang mewakili antarmuka perangkat untuk mengambil array kunci properti perangkat yang diminta.

[out, optional] PropertyKeyArray

Penunjuk ke buffer yang menerima array nilai yang diketik DEVPROPKEY, di mana setiap nilai adalah kunci properti perangkat untuk properti perangkat yang diatur untuk antarmuka perangkat. Penunjuk bersifat opsional dan dapat berupa NULL. Untuk informasi selengkapnya, lihat bagian Keterangan nanti dalam topik ini.

[in] PropertyKeyCount

Ukurannya, dalam elemen yang diketik DEVPROPKEY, dari buffer PropertyKeyArray. Jika PropertyKeyArrayNULL, PropertyKeyCount harus diatur ke nol.

[out, optional] RequiredPropertyKeyCount

Penunjuk ke variabel berjenis DWORD yang menerima jumlah kunci properti perangkat yang diminta. Penunjuk bersifat opsional dan dapat diatur ke NULL.

[in] Flags

Parameter ini harus diatur ke nol.

Nilai kembali

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan 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_DATA	Nilai data internal tidak valid.
ERROR_INVALID_PARAMETER	Parameter tidak valid. Salah satu kemungkinannya adalah antarmuka perangkat yang ditentukan oleh DevInterfaceData tidak valid.
ERROR_INVALID_USER_BUFFER	Buffer pengguna tidak valid. Salah satu kemungkinannya adalah PropertyKeyArray adalah NULL, dan PropertKeyCount bukan nol. .
ERROR_NO_SUCH_DEVICE_INTERFACE	Antarmuka perangkat yang ditentukan oleh DeviceInterfaceData tidak ada.
ERROR_INSUFFICIENT_BUFFER	Buffer PropertyKeyArray tidak cukup besar untuk menahan semua kunci properti yang diminta.
ERROR_NOT_ENOUGH_MEMORY	Tidak tersedia cukup memori sistem untuk menyelesaikan operasi.

Keterangan

SetupDiGetDeviceInterfacePropertyKeys adalah bagian dari model properti perangkat terpadu.

Jika buffer PropertyKeyArray tidak cukup besar untuk menahan semua kunci properti yang diminta, SetupDiGetDeviceInterfacePropertyKeys tidak mengambil kunci properti apa pun dan mengembalikan ERROR_INSUFFICIENT_BUFFER. Jika penelepon menyediakan penunjuk RequiredPropertyKeyCount, SetupDiGetDeviceInterfacePropertyKeys menetapkan nilai *RequiredPropertyKeyCount ke ukuran yang diperlukan, dalam nilai yang diketik DEVPROPKEY, dari buffer PropertyKeyArray.

Untuk mengambil properti antarmuka perangkat, panggil SetupDiGetDeviceInterfaceProperty, dan untuk mengatur properti antarmuka perangkat, panggil SetupDiSetDeviceInterfaceProperty.

Persyaratan

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

Lihat juga

SetupDiGetDeviceInterfaceProperty

SetupDiSetDeviceInterfaceProperty