Fonction StorPortAllocateRegistryBuffer (storport.h)
La routine StorPortAllocateRegistryBuffer est appelée par le pilote miniport pour allouer une mémoire tampon qui peut être utilisée pour lire et écrire des données du Registre.
Syntaxe
STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
[in] PVOID HwDeviceExtension,
[in] PULONG Length
);
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] Length
Pointeur vers un long qui indique, lors de l’entrée, la longueur en octets de la mémoire tampon du Registre dont l’appelant a besoin. Sur la sortie, Longueur est mis à jour pour refléter la taille réelle en octets de la mémoire tampon qui a été allouée.
Valeur retournée
StorPortAllocateRegistryBuffer retourne un pointeur vers la mémoire tampon du Registre demandée par l’appelant, ou NULL si une erreur empêche l’allocation de la mémoire.
Remarques
Chaque instanciation d’un pilote miniport ne peut avoir qu’une seule mémoire tampon de Registre allouée à la fois. Si un pilote miniport tente d’allouer plusieurs mémoires tampons de Registre, l’allocation échoue et StorPortAllocateRegistryBuffer retourne la valeur NULL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | storport.h (inclure Storport.h) |
| Bibliothèque | Storport.lib |