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

Voir aussi

StorPortFreeRegistryBuffer