IoOpenDeviceInterfaceRegistryKey 函式 (wdm.h)

發行項
02/29/2024

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。可能的錯誤傳回值包括下列專案。

傳回碼	Description
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 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (请参阅一节)
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)