AtaPortRegistryAllocateBuffer, fonction (irb.h)

La routine AtaPortRegistryAllocateBuffer alloue une mémoire tampon pour les opérations de Registre.

Remarque Le pilote de port ATA et les modèles de pilotes miniport ATA peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le du pilote Storport et modèles de pilotes Storport miniport.

 

Syntaxe

PVOID AtaPortRegistryAllocateBuffer(
  [in] PVOID ChannelExtension,
       ULONG BufferSize
);

Paramètres

[in] ChannelExtension

Pointeur vers l’extension de canal.

BufferSize

Spécifie la longueur de la mémoire tampon, en octets.

Valeur de retour

AtaPortRegistryAllocateBuffer retourne un pointeur vers la mémoire tampon allouée en cas de réussite. Sinon, elle retourne NULL .

Remarques

Le pilote de port permet au pilote miniport d’allouer une mémoire tampon pour toutes ses opérations de Registre. Une fois que le pilote miniport a alloué une mémoire tampon avec AtaPortRegistryAllocateBuffer, les appels ultérieurs à AtaPortRegistryAllocateBuffer échouent et retournent NULL. Une fois que le pilote miniport libère la mémoire tampon allouée avec un appel à la routine AtaPortRegistryFreeBuffer, il peut à nouveau allouer des mémoires tampons en appelant AtaPortRegistryAllocateBuffer.

Le pilote miniport doit appeler AtaPortRegistryAllocateBuffer dans sa routine AtaChannelInitRoutine ou dans sa routine IdeHwControl. Il ne peut pas appeler AtaPortRegistryAllocateBuffer à partir d’une autre routine. En outre, le pilote miniport ne peut appeler qu'AtaPortRegistryAllocateBuffer à partir de sa routine IdeHwControl si sa routine IdeHwControl a été appelée et avait une valeur de StartChannel ou StopChannel dans son paramètre ControlAction .

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	irb.h (include Ata.h, Irb.h)
bibliothèque	Ataport.lib ; Pciidex.lib

Voir aussi

AtaChannelInitRoutine

AtaPortRegistryFreeBuffer

IdeHwControl