IoOpenDeviceInterfaceRegistryKey 函式（wdm.h）

發行項
02/07/2025

IoOpenDeviceInterfaceRegistryKey 例程會傳回登錄機碼的句柄，以儲存特定裝置介面實例的相關信息。

語法

NTSTATUS IoOpenDeviceInterfaceRegistryKey(
  [in]  PUNICODE_STRING SymbolicLinkName,
  [in]  ACCESS_MASK     DesiredAccess,
  [out] PHANDLE         DeviceInterfaceRegKey
);

參數

[in] SymbolicLinkName

識別裝置介面實例之字串的指標。此字串是從先前呼叫 ioGetDeviceInterfaces 、IoGetDeviceInterfaceAlias或 IoRegisterDeviceInterface取得。

[in] DesiredAccess

指定代表呼叫端對索引鍵所需的存取權 ACCESS_MASK 值，例如KEY_READ、KEY_WRITE或KEY_ALL_ACCESS。如需每個 KEY_XXX 訪問許可權的描述，請參閱 ZwCreateKey。

[out] DeviceInterfaceRegKey

如果呼叫成功，則傳回登錄機碼之傳回句柄的指標。

傳回值

IoOpenDeviceInterfaceRegistryKey 如果呼叫成功，就會傳回STATUS_SUCCESS。可能的錯誤傳回值包括下列專案。

傳回碼	描述
STATUS_OBJECT_NAME_NOT_FOUND	例程無法找到裝置介面實例的登錄機碼，可能是因為 SymbolicLinkName發生錯誤。
STATUS_OBJECT_PATH_NOT_FOUND	例程無法找到裝置介面實例的登錄機碼，可能是因為 SymbolicLinkName發生錯誤。
STATUS_INVALID_PARAMETER	可能表示 SymbolicLinkName中發生錯誤。

言論

IoOpenDeviceInterfaceRegistryKey 會針對 SymbolicLinkName所指定的裝置介面實例，開啟登錄機碼的非volatile 子機碼。驅動程式可以將資訊儲存在這個裝置介面實例特有的子機碼中，例如相機的預設解析度。使用者模式應用程式可以使用 SetupDiXxx 例程來存取此子機碼。

驅動程式必須呼叫 ZwClose，才能在不再需要存取時關閉從這個例程傳回的句柄。

IoOpenDeviceInterfaceRegistryKey 的呼叫者 必須在系統線程的內容中於 IRQL = PASSIVE_LEVEL執行。

要求

要求	價值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平臺	普遍
標頭	wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL （請參閱一節）
DDI 合規性規則	HwStorPortProhibitedDIs（storport），PowerIrpDDis（wdm）