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
STATUS_OBJECT_NAME_NOT_FOUND	Rutinitas tidak dapat menemukan kunci registri untuk instans antarmuka perangkat, mungkin karena kesalahan dalam SymbolicLinkName.
STATUS_OBJECT_PATH_NOT_FOUND	Rutinitas tidak dapat menemukan kunci registri untuk instans antarmuka perangkat, mungkin karena kesalahan dalam SymbolicLinkName.
STATUS_INVALID_PARAMETER	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)

Lihat juga

ACCESS_MASK

IoGetDeviceInterfaceAlias

IoGetDeviceInterfaces

IoRegisterDeviceInterface

ZwClose