Fonction StorPortRegistryReadAdapterKey (storport.h)

Article
04/23/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 à partir de 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 que le pilote miniport a appelé StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil. Le pilote miniport doit être en cours d’exécution 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 Unicode terminée par null.
REG_EXPAND_SZ	Chaîne unicode terminée par un null 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 peu 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 le mappage de ressources.
REG_FULL_RESOURCE_DESCRIPTOR	Liste de 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 petit endian.

[in, out] ValueData

Pointeur vers les données qui contiennent les données du 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 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