StorPortRegistryWrite, fonction (storport.h)

Article
02/07/2025

La routine StorPortRegistryWrite est appelée par le pilote miniport pour convertir les données de Registre contenues dans une mémoire tampon spécifiée d’ASCII en Unicode, puis écrire les données dans la zone de stockage par HBA du pilote miniport.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel. Il s’agit d’une zone de stockage par HBA que le pilote de port alloue et initialise pour le compte du pilote miniport. Les pilotes miniport stockent généralement des informations spécifiques à l’adaptateur HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées pour l’adaptateur HBA. Cette zone est disponible pour le pilote miniport immédiatement après l’appel du pilote miniport StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil. Le pilote miniport doit s’exécuter au PASSIVE_LEVEL IRQL lorsqu’il appelle cette routine.

[in] ValueName

Pointeur vers une chaîne qui spécifie le nom de la valeur.

[in] Global

Indique si l’opération doit être spécifique à l’adaptateur ou pour être liée à tous les adaptateurs.

[in] Type

L’un des types de données de Registre suivants.

Type	Signification
REG_SZ	Chaîne null Unicode terminée.
REG_EXPAND_SZ	Chaîne terminée par null Unicode avec références de variable d’environnement.
REG_BINARY	Données binaires.
REG_DWORD	Double mot 32 bits.
REG_DWORD_LITTLE_ENDIAN	Double mot 32 bits avec un format little-endian.
REG_DWORD_BIG_ENDIAN	Double mot 32 bits avec un format big-endian.
REG_LINK	Chaîne Unicode qui spécifie un lien symbolique.
REG_MULTI_SZ	Plusieurs chaînes Unicode.
REG_RESOURCE_LIST	Liste des ressources dans le mappage de ressources.
REG_FULL_RESOURCE_DESCRIPTOR	Liste des ressources dans la description matérielle.
REG_RESOURCE_REQUIREMENTS_LIST	Liste des conditions requises pour les ressources.
REG_QWORD	Numéro de quadlet 64 bits.
REG_QWORD_LITTLE_ENDIAN	Nombre quadlet 64 bits avec un format de petit endian.

[in] Buffer

Pointeur vers une mémoire tampon qui contient les données de Registre à écrire.

[in] BufferLength

Spécifie la taille de la mémoire tampon pointée par tampon.

Valeur de retour

StorPortRegistryWrite retourne une valeur booléenne de TRUE si les données du Registre ont été correctement converties et écrites ; sinon, cette routine retourne FALSE.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
bibliothèque	Storport.lib
IRQL	PASSIVE_LEVEL
règles de conformité DDI	StorPortIrql(storport)

Voir aussi

StorPortInitialize

Partager via