Funzione IoOpenDeviceInterfaceRegistryKey (wdm.h)

Articolo
08/08/2023

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

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, IoGetDeviceInterfaceAlias o IoRegisterDeviceInterface.

[in] DesiredAccess

Specifica il valore ACCESS_MASK che rappresenta l'accesso richiesto al chiamante, ad esempio KEY_READ, KEY_WRITE o KEY_ALL_ACCESS. Per una descrizione di ogni diritto di accesso KEY_XXX, 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 degli errori 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 in 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 in SymbolicLinkName.
STATUS_INVALID_PARAMETER	Possibilmente indica un errore in SymbolicLinkName.

Commenti

IoOpenDeviceInterfaceRegistryKey apre una sottochiave nonvolatile della chiave del Registro di sistema per l'istanza dell'interfaccia del dispositivo specificata da SimbolicLinkName. 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.

Requisiti

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)

Vedi anche

ACCESS_MASK

IoGetDeviceInterfaceAlias

IoGetDeviceInterfaces

IoRegisterDeviceInterface

ZwClose

Condividi tramite