Fungsi WdfDeviceAssignProperty (wdfdevice.h)
[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 |
---|---|
|
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 |