Função AtaPortRegistryControllerKeyWrite (irb.h)

Artigo
02/26/2024

A rotina AtaPortRegistryControllerKeyWrite grava os dados no nome do valor indicado na chave HKLM\CurrentControlSet\Services\<service name>\ControllerNdo Registro , em que N é o número do controlador.

Nota Os modelos de driver de porta do ATA e do driver de miniporto do ATA podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver do Storport e do driver de miniporto storport .

Sintaxe

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

Parâmetros

[in] ChannelExtension

Um ponteiro para a extensão de canal.

[in] ControllerNumber

Contém o número do controlador.

[in] ValueName

Contém o nome do valor do Registro no qual gravar.

[in] ValueType

Indica o tipo de dados contido no valor do Registro. Esse membro deve receber um dos valores indicados na tabela a seguir.

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.

[in] Buffer

Um ponteiro para o buffer de origem que contém os dados a serem gravados no valor do Registro.

BufferLength

Um ponteiro para o número de bytes de dados a serem copiados. Se a operação falhar, o local apontado por Length atualizará o comprimento dos dados que foram copiados com êxito para o registro.

Retornar valor

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

Comentários

O buffer deve ser alocado usando AtaPortRegistryAllocateBuffer.

O driver de miniporte deve chamar AtaPortRegistryControllerKeyWrite durante a rotina AtaChannelInitRoutine ou a rotina IdeHwControl .; O driver de miniporto não pode chamar AtaPortRegistryControllerKeyWrite de qualquer outra rotina ou retornará FALSE. Além disso, o driver de miniporto só poderá chamar AtaPortRegistryControllerKeyWrite de sua rotina IdeHwControl se sua rotina IdeHwControl fosse chamada e tivesse um valor de StartChannel ou StopChannel em seu parâmetro ControlAction .

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	irb.h (inclua Ata.h, Irb.h)

Confira também

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

IdeHwControl

Compartilhar via