Função AtaPortRegistryAllocateBuffer (irb.h)

A rotina de AtaPortRegistryAllocateBuffer aloca um buffer para operações do Registro.

Observação o driver de porta do ATA e os modelos de driver de miniporto do ATA podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

 

Sintaxe

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

Parâmetros

[in] ChannelExtension

Um ponteiro para a extensão do canal.

BufferSize

Especifica o comprimento do buffer, em bytes.

Valor de retorno

AtaPortRegistryAllocateBuffer retorna um ponteiro para o buffer alocado com êxito. Caso contrário, ele retornará NULL.

Observações

O driver de porta permite que o driver de miniporto aloque um buffer para todas as operações do Registro. Depois que o driver de miniporto alocar um buffer com AtaPortRegistryAllocateBuffer, chamadas posteriores para AtaPortRegistryAllocateBuffer falharão e retornarão NULL. Depois que o driver de miniporto libera o buffer alocado com uma chamada para a rotina de AtaPortRegistryFreeBuffer, ele pode alocar buffers novamente chamando AtaPortRegistryAllocateBuffer.

O driver de miniporto deve chamar AtaPortRegistryAllocateBuffer em sua rotina de AtaChannelInitRoutine ou em sua rotina de IdeHwControl. Ele não pode chamar AtaPortRegistryAllocateBuffer de qualquer outra rotina. Além disso, o driver de miniporto só pode chamar AtaPortRegistryAllocateBuffer de sua rotina de IdeHwControl se sua rotina de IdeHwControl foi chamada e tinha um valor de StartChannel ou StopChannel em seu parâmetro controlaction .

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	irb.h (include Ata.h, Irb.h)
biblioteca	Ataport.lib; Pciidex.lib

Consulte também

AtaChannelInitRoutine

AtaPortRegistryFreeBuffer

IdeHwControl