StorPortRegistryReadAdapterKey, fonction (storport.h)

Article
02/07/2025

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 à HKLM/CurrentControlSet/Enum/chemin d’accès de l’instance/DeviceParameters/... ces clés sont lues dans la section INF DDInstall.HW.

Syntaxe

ULONG StorPortRegistryReadAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  *ValueData,
  [in, out]      PULONG 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 à 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, optional] SubKeyName

Sous-clé miniport.

[in] ValueName

Nom de la valeur sous la clé.

[in] ValueType

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, out] ValueData

Pointeur vers les données qui contiennent les données de Registre à lire. Les données sont converties 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 de retour

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

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
bibliothèque	Storport.lib
IRQL	PASSIVE_LEVEL

Voir aussi

StorPortInitialize

Partager via