Fungsi IoSetDeviceInterfacePropertyData (wdm.h)

  • Artikel

Rutinitas IoSetDeviceInterfacePropertyData memodifikasi nilai properti antarmuka perangkat saat ini.

Sintaks

NTSTATUS IoSetDeviceInterfacePropertyData(
  [in]           PUNICODE_STRING  SymbolicLinkName,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           LCID             Lcid,
  [in]           ULONG            Flags,
  [in]           DEVPROPTYPE      Type,
  [in]           ULONG            Size,
  [in, optional] PVOID            Data
);

Parameter

[in] SymbolicLinkName

Penunjuk ke string yang mengidentifikasi instans antarmuka perangkat. String ini diperoleh dari panggilan sebelumnya ke rutinitas IoGetDeviceInterfaces, IoGetDeviceInterfaceAlias, atau IoRegisterDeviceInterface .

[in] PropertyKey

Penunjuk ke struktur DEVPROPKEY yang berisi kunci properti antarmuka perangkat.

[in] Lcid

Menentukan pengidentifikasi lokal. Atur parameter ini ke nilai LCID khusus bahasa atau ke LOCALE_NEUTRAL. LOCALE_NEUTRAL LCID menentukan bahwa properti netral bahasa (yaitu, tidak khusus untuk bahasa apa pun). Jangan atur parameter ini ke LOCALE_SYSTEM_DEFAULT atau LOCALE_USER_DEFAULT. Untuk informasi selengkapnya tentang nilai LCID khusus bahasa, lihat Struktur LCID.

[in] Flags

Atur parameter ini ke PLUGPLAY_PROPERTY_PERSISTENT jika nilai properti yang ditetapkan oleh rutinitas ini harus bertahan di seluruh komputer dimulai ulang. Jika tidak, atur Bendera ke nol.

[in] Type

Atur parameter ini ke nilai DEVPROPTYPE yang menentukan jenis data yang disediakan dalam buffer Data .

[in] Size

Menentukan ukuran, dalam byte, dari buffer yang dituju data .

[in, optional] Data

Penunjuk ke data properti antarmuka perangkat. Atur parameter ini ke NULL untuk menghapus properti yang ditentukan. Jika Data bukan NULL, rutin menyimpan salinan internal nilai properti. Buffer yang diacu oleh Data tidak perlu tetap valid setelah panggilan kembali.

Nilai kembali

IoSetDeviceInterfacePropertyData mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Menampilkan kode Deskripsi
STATUS_UNSUCCESSFUL Nilai LCID yang ditentukan tidak valid.
STATUS_NOT_IMPLEMENTED Properti yang ditentukan tidak didukung.

Keterangan

Driver mode kernel menggunakan rutinitas IoSetDeviceInterfacePropertyData untuk memodifikasi properti antarmuka perangkat yang didefinisikan sebagai bagian dari model properti perangkat terpadu. Untuk informasi selengkapnya tentang properti antarmuka perangkat, lihat Properti Perangkat.

Driver dapat menggunakan rutinitas IoGetDeviceInterfacePropertyData untuk mendapatkan nilai saat ini untuk properti antarmuka perangkat.

Penelepon IoSetDeviceInterfacePropertyData harus berjalan di IRQL <= APC_LEVEL dalam konteks utas sistem.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia untuk Windows versi Windows 8 dan yang lebih baru.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData