Funzione StorPortRegistryWrite (storport.h)

Articolo
03/05/2024

La routine StorPortRegistryWrite viene chiamata dal driver miniport per convertire i dati del Registro di sistema contenuti in un buffer specificato da ASCII a Unicode e quindi scrivere i dati nell'area di archiviazione per hbA del driver miniport.

Sintassi

STORPORT_API BOOLEAN StorPortRegistryWrite(
  [in] PVOID  HwDeviceExtension,
  [in] PUCHAR ValueName,
  [in] ULONG  Global,
  [in] ULONG  Type,
  [in] PUCHAR Buffer,
  [in] ULONG  BufferLength
);

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] ValueName

Puntatore a una stringa che specifica il nome del valore.

[in] Global

Indica se l'operazione deve essere specifica o correlata a tutte le schede.

[in] Type

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] Buffer

Puntatore a un buffer contenente i dati del Registro di sistema da scrivere.

[in] BufferLength

Specifica le dimensioni del buffer a cui punta Buffer.

Valore restituito

StorPortRegistryWrite restituisce un valore booleano TRUE se i dati del Registro di sistema sono stati convertiti e scritti correttamente; in caso contrario, questa routine restituisce FALSE.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	storport.h (include Storport.h)
Libreria	Storport.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	StorPortIrql(storport)

Vedi anche

StorPortInitialize

Condividi tramite