Função AtaPortRegistryControllerKeyRead (irb.h)

Artigo
02/07/2025

A rotina AtaPortRegistryControllerKeyRead lê os dados associados ao nome de valor indicado na chave do Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN, em que N é o número do controlador.

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

BOOLEAN AtaPortRegistryControllerKeyRead(
  [in]            PVOID  ChannelExtension,
  [in]            UCHAR  ControllerNumber,
  [in]            PCHAR  ValueName,
  [in]            UCHAR  ValueType,
  [out, optional] PUCHAR Buffer,
                  PULONG BufferLength
);

Parâmetros

[in] ChannelExtension

Um ponteiro para a extensão do canal.

[in] ControllerNumber

Contém o número do controlador.

[in] ValueName

Contém o nome do valor do Registro a ser lido.

[in] ValueType

Indica o tipo dos dados contidos no valor do Registro. Esse parâmetro deve ser atribuído a um dos valores indicados na tabela a seguir.

Tipo de valor	Significado
IDE_REG_DWORD	Um valor numérico de 4 bytes.
IDE_REG_BINARY	Dados binários.
IDE_REG_SZ	Uma cadeia de caracteres Unicode terminada em nulo.

[out, optional] Buffer

Um ponteiro para o buffer em que os resultados devem ser copiados.

BufferLength

Um ponteiro para o número de bytes de dados a serem copiados. Se a operação falhar devido a um buffer insuficiente, o local apontado pelo Length será atualizado para o comprimento real dos dados no registro.

Valor de retorno

AtaPortRegistryControllerKeyRead retornará verdadeiro se a operação for bem-sucedida. Caso contrário, ele retornará FALSE. A rotina de AtaPortRegistryControllerKeyRead também retornará FALSE se o driver de miniporto não chamá-lo da rotina correta.

Observações

O buffer em buffer deve ser alocado usando AtaPortRegistryAllocateBuffer.

O driver de miniporto deve chamar AtaPortRegistryControllerKeyRead em sua rotina de AtaChannelInitRoutine ou em sua rotina de IdeHwControl. Ele não pode chamar AtaPortRegistryControllerKeyRead de qualquer outra rotina. Além disso, o driver de miniporto só pode chamar AtaPortRegistryControllerKeyRead 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)

Consulte também

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

IdeHwControl

Compartilhar via