共用方式為

IoOpenDeviceInterfaceRegistryKey 函式 (wdm.h)

  • 發行項

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)

另請參閱

ACCESS_MASK

IoGetDeviceInterfaceAlias

IoGetDeviceInterfaces

IoRegisterDeviceInterface

ZwClose