Bagikan melalui

Fungsi SetupDiSetDeviceInterfacePropertyW (setupapi.h)

Fungsi SetupDiSetDeviceInterfaceProperty mengatur properti perangkat antarmuka perangkat.

Sintaks

WINSETUPAPI BOOL SetupDiSetDeviceInterfacePropertyW(
  [in]           HDEVINFO                  DeviceInfoSet,
  [in]           PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]           const DEVPROPKEY          *PropertyKey,
  [in]           DEVPROPTYPE               PropertyType,
  [in, optional] const PBYTE               PropertyBuffer,
  [in]           DWORD                     PropertyBufferSize,
  [in]           DWORD                     Flags
);

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat yang berisi antarmuka perangkat untuk mengatur properti antarmuka perangkat.

[in] DeviceInterfaceData

Penunjuk ke struktur SP_DEVICE_INTERFACE_DATA yang mewakili antarmuka perangkat untuk mengatur properti antarmuka perangkat.

[in] PropertyKey

Penunjuk ke struktur DEVPROPKEY yang mewakili kunci properti perangkat dari properti antarmuka perangkat yang akan diatur.

[in] PropertyType

Nilai berjenis DEVPROPTYPE yang mewakili pengidentifikasi tipe data properti dari properti antarmuka perangkat yang akan diatur. Untuk informasi selengkapnya tentang pengidentifikasi tipe data properti, lihat bagian Keterangan nanti dalam topik ini.

[in, optional] PropertyBuffer

Penunjuk ke buffer yang berisi nilai properti antarmuka perangkat. Jika properti atau nilai antarmuka sedang dihapus, penunjuk ini harus diatur ke NULL, dan PropertyBufferSize harus diatur ke nol. Untuk informasi selengkapnya tentang data nilai properti, lihat bagian Keterangan nanti dalam topik ini.

[in] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer . Ukuran buffer properti harus konsisten dengan pengidentifikasi tipe data properti yang disediakan oleh PropertyType. Jika PropertyBuffer diatur ke NULL, PropertyBufferSize harus diatur ke nol.

[in] Flags

Harus diatur ke nol.

Menampilkan nilai

SetupDiSetDeviceInterfaceProperty mengembalikan TRUE jika berhasil. Jika tidak, fungsi ini 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_PARAMETER
 Parameter yang disediakan tidak valid. Salah satu kemungkinannya adalah antarmuka perangkat yang ditentukan oleh DeviceInterfaceData tidak valid.
ERROR_INVALID_REG_PROPERTY
 Kunci properti yang disediakan oleh PropertyKey tidak valid.
ERROR_INVALID_DATA
 Nilai data yang tidak ditentukan tidak valid. Kesalahan ini dapat dicatat jika nama tautan simbolis antarmuka perangkat tidak valid atau pengidentifikasi tipe data properti tidak valid.
ERROR_INVALID_USER_BUFFER
 Buffer pengguna tidak valid. Salah satu kemungkinannya adalah propertyBuffer adalah NULL, dan PropertBufferSize bukan nol.
ERROR_NO_SUCH_DEVICE_INTERFACE
 Antarmuka perangkat yang ditentukan oleh DeviceInterfaceData tidak ada.
ERROR_INSUFFICIENT_BUFFER
 Buffer data internal yang diteruskan ke panggilan sistem terlalu kecil.
ERROR_NOT_ENOUGH_MEMORY
 Tidak tersedia cukup memori sistem untuk menyelesaikan operasi.
ERROR_NOT_FOUND
 Elemen internal yang tidak ditentukan tidak ditemukan. Salah satu kemungkinan adalah bahwa properti yang akan dihapus tidak ada.
ERROR_ACCESS_DENIED
 Pemanggil tidak memiliki hak istimewa Administrator.

Keterangan

SetupDiSetDeviceInterfaceProperty adalah bagian dari model properti perangkat terpadu.

SetupAPI hanya mendukung setupDiSetDeviceInterfaceProperty versi Unicode.

Penelepon SetupDiSetDeviceInterfaceProperty harus menjadi anggota grup Administrator untuk mengatur properti antarmuka perangkat.

SetupDiSetDeviceInterfaceProperty memberlakukan persyaratan pada pengidentifikasi jenis data properti dan nilai properti.

Untuk mendapatkan kunci properti perangkat yang mewakili properti perangkat yang diatur untuk antarmuka perangkat, panggil SetupDiGetDeviceInterfacePropertyKeys.

Untuk mengambil properti antarmuka perangkat, panggil SetupDiGetDeviceInterfaceProperty.

Persyaratan

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

Lihat juga

SetupDiGetDeviceInterfaceProperty

SetupDiGetDeviceInterfacePropertyKeys

  • Last updated on