Fungsi WdfRegistryAssignValue (wdfregistry.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfRegistryAssignValue menetapkan data tertentu ke nama nilai tertentu dalam registri.
Sintaks
NTSTATUS WdfRegistryAssignValue(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[in] ULONG ValueType,
[in] ULONG ValueLength,
[in] PVOID Value
);
Parameter
[in] Key
Handel ke objek kunci registri yang mewakili kunci registri yang dibuka.
[in] ValueName
Penunjuk ke struktur UNICODE_STRING yang berisi nama nilai.
[in] ValueType
Nilai yang mengidentifikasi jenis data. Untuk daftar nilai tipe data, lihat Tipe anggota KEY_VALUE_BASIC_INFORMATION.
[in] ValueLength
Panjangnya, dalam byte, dari buffer yang dirujuk Nilai .
[in] Value
Penunjuk ke buffer yang berisi data yang disediakan driver.
Nilai kembali
WdfRegistryAssignValue mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
WdfRegistryAssignValue tidak dipanggil di IRQL = PASSIVE_LEVEL. |
|
Parameter yang tidak valid ditentukan. |
|
Driver tidak membuka kunci registri dengan akses KEY_SET_VALUE. |
Metode ini juga mungkin mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Jika nama nilai yang ditentukan parameter ValueName sudah ada, WdfRegistryAssignValue memperbarui data nilai.
Untuk informasi selengkapnya tentang objek kunci registri, lihat Menggunakan Registri di Driver Framework-Based.
Contoh
Contoh kode berikut menetapkan 123456 heksadesimal ke nilai registri sebagai data biner.
ULONG val;
NTSTATUS status;
val = 0x123456;
status = WdfRegistryAssignValue(
Key,
&valueName,
REG_BINARY,
sizeof(val),
&val
);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Versi UMDF minimum | 2.0 |
Header | wdfregistry.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk