Funzione AtaPortRegistryAllocateBuffer (irb.h)
La routine AtaPortRegistryAllocateBuffer alloca un buffer per le operazioni del Registro di sistema.
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.
Commenti
Il driver della 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 ad AtaPortRegistryAllocateBuffer avranno esito negativo e restituiranno NULL. Dopo che il driver miniport libera il buffer allocato con una chiamata alla routine AtaPortRegistryFreeBuffer , può di nuovo allocare 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 AtaPortRegistryAllocateBuffer dalla routine IdeHwControl solo se è stata chiamata la routine IdeHwControl e ha un valore di StartChannel o StopChannel nel parametro ControlAction.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | irb.h (include Ata.h, Irb.h) |
Libreria | Ataport.lib; Pciidex.lib |