Fungsi WdfDriverOpenPersistentStateRegistryKey (wdfdriver.h)
Driver harus menggunakan WdfDriverOpenPersistentStateRegistryKey untuk menulis informasi persisten driver yang luas ke registri.
Sintaks
NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
[in] WDFDRIVER Driver,
[in] ACCESS_MASK DesiredAccess,
[in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
[out] WDFKEY *Key
);
Parameter
[in] Driver
Handel ke objek driver kerangka kerja driver yang diperoleh driver dari panggilan sebelumnya ke WdfDriverCreate atau WdfGetDriver.
[in] DesiredAccess
Nilai ACCESS_MASK yang ditik yang menentukan masker akses untuk kunci registri. Driver KMDF biasanya meminta KEY_WRITE KEY_READ, KEY_WRITE, atau KEY_READ | . Jika Anda menulis driver UMDF, gunakan KEY_SET_VALUE KEY_READ atau KEY_READ | . Sebagai praktik terbaik, mintalah hanya jenis akses yang dibutuhkan driver Anda.
[in, optional] KeyAttributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon yang menentukan atribut objek untuk objek kunci registri kerangka kerja. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
[out] Key
Penunjuk ke lokasi yang menerima handel ke objek kunci registri kerangka kerja.
Nilai kembali
Lihat WdfDriverOpenParametersRegistryKey.
Keterangan
Kuncinya Parameters adalah untuk pengaturan yang tidak dapat diubah yang disediakan dalam file INF. Untuk mengakses pengaturan tersebut, gunakan WdfDriverOpenParametersRegistryKey. Kunci yang dikembalikan dari API ini adalah untuk pengaturan yang ditulis saat runtime.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10, versi 1803 |
| Versi KMDF minimum | 1.25 |
| Versi UMDF minimum | 2,25 |
| Header | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |