Fungsi WdfDeviceAssignProperty (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceAssignProperty memodifikasi pengaturan properti perangkat saat ini.

Sintaks

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 berjenis DEVPROPTYPE yang menentukan jenis data yang disimpan dalam Data.

[in] Size

Ukuran, dalam byte, dari buffer yang diacu 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.

Nilai kembali

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

Menampilkan 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.

Keterangan

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

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

Persyaratan

Persyaratan Nilai
Target Platform 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