Partager via

StorPortRegistryWriteAdapterKey, fonction (storport.h)

  • Article

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