Fungsi WdfDeviceAssignProperty (wdfdevice.h)

Artikel
07/02/2025

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceAssignProperty memodifikasi pengaturan properti perangkat saat ini.

Sintaksis

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] DeviceProperty

Penunjuk ke struktur WDF_DEVICE_PROPERTY_DATA yang mengidentifikasi properti perangkat untuk dimodifikasi.

[in] Type

Variabel DEVPROPTYPE-typed yang menentukan jenis data yang disimpan di Data.

[in] Size

Ukuran, dalam byte, dari buffer yang ditujukkan oleh Data.

[in, optional] Data

Penunjuk ke buffer yang dialokasikan pemanggil yang berisi data properti perangkat. Atur parameter ini ke NULL untuk menghapus properti yang ditentukan.

Mengembalikan nilai

Jika operasi berhasil, WdfDeviceAssignProperty mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Mengembalikan kode	Deskripsi
STATUS_INVALID_PARAMETER	Salah satu parameter salah.

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Komentar

Anda dapat menggunakan WdfDeviceAssignProperty untuk memodifikasi pengaturan properti apa pun yang diekspos melalui model properti terpadu.

Untuk informasi tentang metode terkait, lihat Mengakses Model Properti Perangkat Terpadu.

Persyaratan

Syarat	Nilai
Platform Target	Universal
versi KMDF Minimum	1.13
versi UMDF Minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	APC_LEVEL

Lihat juga

WdfDeviceAssignInterfaceProperty

Bagikan melalui