Funzione IoOpenDeviceInterfaceRegistryKey (wdm.h)

Articolo
02/07/2025

La routine IoOpenDeviceInterfaceRegistryKey restituisce un handle a una chiave del Registro di sistema per archiviare informazioni su una particolare istanza dell'interfaccia del dispositivo.

Sintassi

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

Parametri

[in] SymbolicLinkName

Puntatore a una stringa che identifica l'istanza dell'interfaccia del dispositivo. Questa stringa è stata ottenuta da una chiamata precedente a IoGetDeviceInterfaces, IoGetDeviceInterfaceAliaso IoRegisterDeviceInterface.

[in] DesiredAccess

Specifica il valore ACCESS_MASK che rappresenta l'accesso richiesto dal chiamante alla chiave, ad esempio KEY_READ, KEY_WRITE o KEY_ALL_ACCESS. Per una descrizione di ogni KEY_XXX diritto di accesso, vedere ZwCreateKey.

[out] DeviceInterfaceRegKey

Puntatore a un handle restituito alla chiave del Registro di sistema richiesta se la chiamata ha esito positivo.

Valore restituito

IoOpenDeviceInterfaceRegistryKey restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. I valori restituiti di errore possibili includono quanto segue.

Codice restituito	Descrizione
STATUS_OBJECT_NAME_NOT_FOUND	La routine non è stata in grado di individuare una chiave del Registro di sistema per l'istanza dell'interfaccia del dispositivo, probabilmente a causa di un errore nel SymbolicLinkName.
STATUS_OBJECT_PATH_NOT_FOUND	La routine non è stata in grado di individuare una chiave del Registro di sistema per l'istanza dell'interfaccia del dispositivo, probabilmente a causa di un errore nel SymbolicLinkName.
STATUS_INVALID_PARAMETER	Possibilmente indica un errore nel SymbolicLinkName.

Osservazioni

IoOpenDeviceInterfaceRegistryKey apre una sottochiave non volatile della chiave del Registro di sistema per l'istanza dell'interfaccia del dispositivo specificata da SymbolicLinkName. I driver possono archiviare informazioni in questa sottochiave specifica per questa istanza dell'interfaccia del dispositivo, ad esempio la risoluzione predefinita per una fotocamera. Le applicazioni in modalità utente possono accedere a questa sottochiave usando routine SetupDiXxx.

Il driver deve chiamare ZwClose per chiudere l'handle restituito da questa routine quando l'accesso non è più necessario.

I chiamanti di IoOpenDeviceInterfaceRegistryKey devono essere in esecuzione in IRQL = PASSIVE_LEVEL nel contesto di un thread di sistema.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 2000.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (vedere la sezione Osservazioni)
regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedere anche

ACCESS_MASK

IoGetDeviceInterfaceAlias

IoGetDeviceInterfaces

IoRegisterDeviceInterface

ZwClose

Condividi tramite