Funzione AtaPortRegistryAllocateBuffer (irb.h)

La routine AtaPortRegistryAllocateBuffer alloca un buffer per le operazioni del Registro di sistema.

Nota I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

 

Sintassi

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

Parametri

[in] ChannelExtension

Puntatore all'estensione del canale.

BufferSize

Specifica la lunghezza del buffer, espressa in byte.

Valore restituito

AtaPortRegistryAllocateBuffer restituisce un puntatore al buffer allocato in caso di esito positivo. In caso contrario, restituisce NULL.

Osservazioni

Il driver di porta consente al driver miniport di allocare un buffer per tutte le operazioni del Registro di sistema. Dopo che il driver miniport ha allocato un buffer con AtaPortRegistryAllocateBuffer, le chiamate successive a AtaPortRegistryAllocateBuffer avranno esito negativo e restituiranno NULL. Dopo che il driver miniport libera il buffer allocato con una chiamata alla routine AtaPortRegistryFreeBuffer, può allocare nuovamente i buffer chiamando AtaPortRegistryAllocateBuffer.

Il driver miniport deve chiamare AtaPortRegistryAllocateBuffer nella routine AtaChannelInitRoutine o nella routine IdeHwControl. Non può chiamare AtaPortRegistryAllocateBuffer da qualsiasi altra routine. Inoltre, il driver miniport può chiamare solo AtaPortRegistryAllocateBuffer dalla routine IdeHwControl se è stata chiamata la routine IdeHwControl e ha un valore StartChannel o StopChannel nel parametro ControlAction .

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	irb.h (include Ata.h, Irb.h)
libreria	Ataport.lib; Pciidex.lib

Vedere anche

AtaChannelInitRoutine

AtaPortRegistryFreeBuffer

IdeHwControl