StorPortRegistryWrite, fonction (storport.h)
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 à 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] 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 à être liée à tous les adaptateurs.
[in] Type
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] Buffer
Pointeur vers une mémoire tampon qui contient les données du Registre à écrire.
[in] BufferLength
Spécifie la taille de la mémoire tampon pointée par Buffer.
Valeur retournée
StorPortRegistryWrite retourne une valeur booléenne true si les données du Registre ont été correctement converties et écrites ; sinon, cette routine retourne FALSE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | storport.h (inclure Storport.h) |
| Bibliothèque | Storport.lib |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | StorPortIrql(storport) |