Funzione StorPortRegistryReadAdapterKey (storport.h)
La routine StorPortRegistryReadAdapterKey viene chiamata dal driver miniport per leggere le chiavi dell'adattatore hardware o del Registro di sistema del dispositivo presenti nel Registro di sistema in HKLM/CurrentControlSet/Enum/Instance path/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 hbA per ogni area di archiviazione che il driver di porta alloca e inizializza per conto del driver miniport. I driver Miniport archivia in genere informazioni specifiche dell'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.
Type | 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 | Doppia parola a 32 bit con un formato little-endian. |
REG_DWORD_BIG_ENDIAN | Doppia parola 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 dell'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 un 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.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Intestazione | storport.h (include Storport.h) |
Libreria | Storport.lib |
IRQL | PASSIVE_LEVEL |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per