Fungsi WdfRegistryWdmGetHandle (wdfregistry.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Metode WdfRegistryWdmGetHandle mengembalikan handel Windows Driver Model (WDM) ke kunci registri yang diwakili objek kunci registri kerangka kerja tertentu.

Sintaks

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Parameter

[in] Key

Handel ke objek kunci registri yang mewakili kunci registri yang dibuka.

Nilai kembali

WdfRegistryWdmGetHandle mengembalikan handel WDM ke kunci registri.

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

Keterangan

Driver KMDF dapat meneruskan handel WDM yang dikembalikan ke rutinitas ZwXxx yang menerima handel WDM sebagai input.

Driver UMDF dapat meneruskan handel yang dikembalikan ke API yang memerlukan HKEY, seperti RegEnumKeyEx.

Handel yang dikembalikan metode WdfRegistryWdmGetHandle valid hingga objek kunci registri dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek kunci registri, penunjuk valid hingga fungsi panggilan balik kembali.

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

Contoh

Contoh kode berikut mendapatkan handel WDM ke kunci registri yang diwakili objek kunci registri kerangka kerja tertentu.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

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)

Bagikan melalui