Fungsi WdfDriverOpenParametersRegistryKey (wdfdriver.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Metode WdfDriverOpenParametersRegistryKey membuka kunci registri Parameter driver dan mengambil handel ke objek kunci registri kerangka kerja yang mewakili kunci.

Sintaks

NTSTATUS WdfDriverOpenParametersRegistryKey(
  [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 jenis ACCESS_MASK yang menentukan masker akses untuk kunci registri Parameter .

Driver KMDF biasanya meminta KEY_READ, KEY_WRITE, atau KEY_READ | KEY_WRITE.

Jika Anda menulis driver UMDF, gunakan KEY_READ atau KEY_READ | KEY_SET_VALUE.

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

WdfDriverOpenParametersRegistryKey mengembalikan STATUS_SUCCESS jika operasi berhasil. Nilai pengembalian tambahan meliputi:

Menampilkan kode	Deskripsi
STATUS_ACCESS_DENIED	Driver UMDF menentukan salah satu bendera berikut dalam parameter DesiredAccess : GENERIC_WRITE KEY_CREATE_SUBKEY WRITE_DAC Karena nilai di atas tidak valid untuk driver UMDF, bendera universal seperti GENERIC_ALL dan STANDARD_RIGHTS_ALL juga menyebabkan WdfDriverOpenParametersRegistryKey gagal dengan nilai yang dikembalikan ini.

Menampilkan kode

Deskripsi

STATUS_ACCESS_DENIED

Driver UMDF menentukan salah satu bendera berikut dalam parameter DesiredAccess :

GENERIC_WRITE
KEY_CREATE_SUBKEY
WRITE_DAC

Karena nilai di atas tidak valid untuk driver UMDF, bendera universal seperti GENERIC_ALL dan STANDARD_RIGHTS_ALL juga menyebabkan WdfDriverOpenParametersRegistryKey gagal dengan nilai yang dikembalikan ini.

Untuk informasi selengkapnya tentang nilai yang dikembalikan, lihat Kesalahan Pembuatan Objek Kerangka Kerja.

Metode ini mungkin juga mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug sistem terjadi jika driver KMDF menentukan handel yang tidak valid di Driver.

Keterangan

Kunci Parameter driver terletak di pohon Layananregistri. Jika kunci Parameter driver tidak ada, metode WdfDriverOpenParametersRegistryKey membuatnya.

Ketika driver telah selesai menggunakan kunci registri Parameter , driver harus memanggil WdfRegistryClose.

Catatan

UMDF tidak mendukung pembuatan subkunci.

Untuk informasi selengkapnya tentang registri, lihat Menggunakan Registri di Driver Framework-Based.

Contoh

Contoh kode berikut membuka kunci registri Parameter driver dan mendapatkan handel ke objek kunci registri kerangka kerja yang mewakili kunci.

WDFKEY hKey;

status = WdfDriverOpenParametersRegistryKey(
                                            Driver,
                                            STANDARD_RIGHTS_ALL,
                                            WDF_NO_OBJECT_ATTRIBUTES,
                                            &hKey
                                            );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfdriver.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)