Fungsi IoOpenDeviceInterfaceRegistryKey (wdm.h)
Rutinitas IoOpenDeviceInterfaceRegistryKey mengembalikan handel ke kunci registri untuk menyimpan informasi tentang instans antarmuka perangkat tertentu.
Sintaks
NTSTATUS IoOpenDeviceInterfaceRegistryKey(
[in] PUNICODE_STRING SymbolicLinkName,
[in] ACCESS_MASK DesiredAccess,
[out] PHANDLE DeviceInterfaceRegKey
);
Parameter
[in] SymbolicLinkName
Penunjuk ke string yang mengidentifikasi instans antarmuka perangkat. String ini diperoleh dari panggilan sebelumnya ke IoGetDeviceInterfaces, IoGetDeviceInterfaceAlias, atau IoRegisterDeviceInterface.
[in] DesiredAccess
Menentukan nilai ACCESS_MASK yang mewakili akses yang diperlukan pemanggil ke kunci, seperti KEY_READ, KEY_WRITE, atau KEY_ALL_ACCESS. Lihat ZwCreateKey untuk deskripsi setiap akses KEY_XXX ke kanan.
[out] DeviceInterfaceRegKey
Penunjuk ke handel yang dikembalikan ke kunci registri yang diminta jika panggilan berhasil.
Nilai kembali
IoOpenDeviceInterfaceRegistryKey mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Rutinitas tidak dapat menemukan kunci registri untuk instans antarmuka perangkat, mungkin karena kesalahan dalam SymbolicLinkName. |
|
Rutinitas tidak dapat menemukan kunci registri untuk instans antarmuka perangkat, mungkin karena kesalahan dalam SymbolicLinkName. |
|
Mungkin menunjukkan kesalahan dalam SymbolicLinkName. |
Keterangan
IoOpenDeviceInterfaceRegistryKey membuka subkunci nonvolatile dari kunci registri untuk instans antarmuka perangkat yang ditentukan oleh SymbolicLinkName. Driver dapat menyimpan informasi dalam subkuncar ini yang khusus untuk instans antarmuka perangkat ini, seperti resolusi default untuk kamera. Aplikasi mode pengguna dapat mengakses subkuntang ini menggunakan rutinitas SetupDiXxx .
Driver harus memanggil ZwClose untuk menutup handel yang dikembalikan dari rutinitas ini ketika akses tidak lagi diperlukan.
Pemanggil IoOpenDeviceInterfaceRegistryKey harus berjalan di IRQL = PASSIVE_LEVEL dalam konteks utas sistem.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
Target Platform | Universal |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL (lihat bagian Keterangan) |
Aturan kepatuhan DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |