Fungsi WdfDeviceOpenDevicemapKey (wdfdevice.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceOpenDevicemapKey membuka kunci DEVICEMAP dan membuat objek kunci registri kerangka kerja yang mewakili kunci registri.

Sintaks

NTSTATUS WdfDeviceOpenDevicemapKey(
  [in]           WDFDEVICE              Device,
  [in]           PCUNICODE_STRING       KeyName,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] KeyName

Penunjuk ke struktur UNICODE_STRING yang menentukan nama subkunci untuk dibuka di bawah DEVICEMAP.

[in] DesiredAccess

Nilai jenis ACCESS_MASK yang menentukan hak akses yang diminta driver untuk kunci registri yang ditentukan.

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

Driver UMDF biasanya meminta KEY_READ atau KEY_SET_VALUE.

[in, optional] KeyAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang berisi atribut yang disediakan driver untuk objek kunci registri baru. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[out] Key

Penunjuk ke lokasi yang menerima handel ke objek kunci registri baru. The

Nilai kembali

WdfDeviceOpenDevicemapKey mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_DEVICE_REQUEST	WdfDeviceOpenDevicemapKey tidak dipanggil di IRQL = PASSIVE_LEVEL.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid ditentukan. Untuk UMDF, nilai pengembalian ini dapat menunjukkan hak akses yang tidak memadai.
STATUS_INSUFFICIENT_RESOURCES	Objek kunci registri tidak dapat dialokasikan.
STATUS_OBJECT_NAME_NOT_FOUND	Kunci registri yang ditentukan tidak ada.

Untuk daftar nilai pengembalian lain yang mungkin dikembalikan oleh metode WdfDeviceOpenDevicemapKey , lihat Kesalahan Pembuatan Objek Kerangka Kerja.

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Registri berisi kunci HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP yang digunakan oleh beberapa driver untuk teknologi lama, seperti port serial dan paralel. Jika driver Anda mendukung teknologi yang menggunakan kunci DEVICEMAP , driver dapat mengakses subkey dan nilai di bawah kunci dengan memanggil WdfDeviceOpenDevicemapKey.

WdfDeviceOpenDevicemapKey mengembalikan Kunci volatil. Ini berarti bahwa informasi tidak dipertahankan ketika sarang registri yang sesuai dibongkar.

Ketika driver telah selesai menggunakan kunci registri yang dibuka dengan WdfDeviceOpenDevicemapKey, driver harus memanggil WdfRegistryClose.

Untuk informasi selengkapnya tentang registri, kunci perangkat keras dan perangkat lunak, dan objek registri, lihat Menggunakan Registri di driver Framework-Based.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.15
Versi UMDF minimum	2.15
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Lihat juga

WdfDeviceOpenRegistryKey

WdfFdoInitOpenRegistryKey

Bagikan melalui