Funzione StorPortRegistryReadAdapterKey (storport.h)

Articolo
02/07/2025

La routine StorPortRegistryReadAdapterKey viene chiamata dal driver miniport per leggere le chiavi dell'adattatore hardware o del Registro di sistema del dispositivo che si trovano nel Registro di sistema in HKLM/CurrentControlSet/Enum/percorso dell'istanza/DeviceParameters/... queste chiavi vengono lette dalla sezione INF DDInstall.HW.

Sintassi

ULONG StorPortRegistryReadAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  *ValueData,
  [in, out]      PULONG ValueDataLength
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione per hba che il driver di porta alloca e inizializza per conto del driver miniport. I driver Miniport archivia in genere informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati per l'HBA. Questa area è disponibile per il driver miniport subito dopo che il driver miniport chiama StorPortInitialize. Il driver della porta libera questa memoria quando rimuove il dispositivo. Il driver miniport deve essere in esecuzione in IRQL PASSIVE_LEVEL quando chiama questa routine.

[in, optional] SubKeyName

Sottochiave miniport.

[in] ValueName

Nome del valore sotto la chiave.

[in] ValueType

Uno dei tipi di dati del Registro di sistema seguenti.

Digitare	Significato
REG_SZ	Stringa con terminazione Null Unicode.
REG_EXPAND_SZ	Stringa con terminazione Null Unicode con riferimenti a variabili di ambiente.
REG_BINARY	Dati binari.
REG_DWORD	Parola doppia a 32 bit.
REG_DWORD_LITTLE_ENDIAN	Parola doppia a 32 bit con un formato little-endian.
REG_DWORD_BIG_ENDIAN	Parola doppia a 32 bit con un formato big-endian.
REG_LINK	Stringa Unicode che specifica un collegamento simbolico.
REG_MULTI_SZ	Più stringhe Unicode.
REG_RESOURCE_LIST	Elenco di risorse nella mappa delle risorse.
REG_FULL_RESOURCE_DESCRIPTOR	Elenco di risorse nella descrizione hardware.
REG_RESOURCE_REQUIREMENTS_LIST	Elenco dei requisiti delle risorse.
REG_QWORD	Numero quadlet a 64 bit.
REG_QWORD_LITTLE_ENDIAN	Numero quadlet a 64 bit con formato little-endian.

[in, out] ValueData

Puntatore ai dati che contengono i dati del Registro di sistema da leggere. I dati vengono convertiti da UNICODE a una stringa ASCII con terminazione NULL.

[in, out] ValueDataLength

Specifica le dimensioni dei dati a cui punta ValueData.

Valore restituito

Restituisce STOR_STATUS_SUCCESS quando l'operazione ha esito positivo; in caso contrario, il codice di errore appropriato.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	storport.h (include Storport.h)
libreria	Storport.lib
IRQL	PASSIVE_LEVEL

Vedere anche

StorPortInitialize

Condividi tramite