StorPortAllocateRegistryBuffer, fonction (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 de 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 à 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] Length
Pointeur vers un long qui indique, en entrée, la longueur en octets de la mémoire tampon de Registre requise par l’appelant. En sortie, longueur est mise à jour pour refléter la taille réelle en octets de la mémoire tampon allouée.
Valeur de retour
StorPortAllocateRegistryBuffer retourne un pointeur vers la mémoire tampon de 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 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 NULL.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | storport.h (include Storport.h) |
| bibliothèque | Storport.lib |