StorPortRegistryWriteAdapterKey, fonction (storport.h)

Article
03/01/2024

La routine StorPortRegistryReadAdapterKey est appelée par le pilote miniport pour lire les clés d’adaptateur de registre de matériel ou de périphérique situées dans le registre à l’adresse HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/... ces clés sont lues dans la section INF DDInstall.HW.

Syntaxe

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

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 à HBA dans cette extension, telles que l’état du 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 que le pilote miniport appelle StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil. Le pilote miniport doit s’exécuter sur IRQL PASSIVE_LEVEL lorsqu’il appelle cette routine.

[in, optional] SubKeyName

Sous-clé miniport.

[in] ValueName

Nom de la valeur sous la clé.

[in] ValueType

Un des types de données de Registre suivants.

Type	Signification
REG_SZ	Chaîne unicode terminée par un caractère Null.
REG_EXPAND_SZ	Chaîne terminée par un caractère Null Unicode avec des 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 de ressources dans la carte des ressources.
REG_FULL_RESOURCE_DESCRIPTOR	Liste des ressources dans la description du matériel.
REG_RESOURCE_REQUIREMENTS_LIST	Liste des besoins en ressources.
REG_QWORD	Nombre quadlet 64 bits.
REG_QWORD_LITTLE_ENDIAN	Nombre quadlet 64 bits avec un format little-endian.

[in, out] ValueData

Pointeur vers les données qui contiennent les données du Registre à lire. Les données sont converties à partir d’UNICODE en chaîne ASCII terminée par NULL.

[in, out] ValueDataLength

Spécifie la taille des données pointées par ValueData.

Valeur retournée

Retourne STOR_STATUS_SUCCESS lorsque l’opération réussit, sinon le code d’erreur approprié.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
Bibliothèque	Storport.lib
IRQL	PASSIVE_LEVEL

Voir aussi

StorPortInitialize

Partager via