Fungsi IoSetDeviceInterfacePropertyData (wdm.h)

Artikel
08/08/2023

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

Bagikan melalui