Função AtaPortRegistryChannelSubkeyWrite (irb.h)
A rotina AtaPortRegistryChannelSubKeyWrite grava dados no nome do valor indicado no HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM
de chave do Registro, em que N é o número do controlador e M é o número do canal.
Sintaxe
BOOLEAN AtaPortRegistryChannelSubkeyWrite(
[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 do canal.
[in] ControllerNumber
Contém o número do controlador.
[in] ValueName
Contém o nome do valor do Registro para o 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 Registro.
BufferLength
Um ponteiro para o número de bytes de dados a serem copiados. Se a operação falhar, o local apontado pelo Length será atualizado para o comprimento dos dados que foram gravados com êxito no registro.
Valor de retorno
AtaPortRegistryChannelSubKeyWrite retornará true se a operação for bem-sucedida. Caso contrário, ele retornará FALSE. A rotina também retornará FALSE se o driver de miniporto não chamá-lo da rotina correta.
Observações
Se o nome do valor não estiver presente, AtaPortRegistryChannelSubKeyWrite criará uma entrada para o valor e os dados serão armazenados no valor recém-criado.
O buffer apontado pelo Buffer deve ser alocado usando AtaPortRegistryAllocateBuffer.
O driver de miniporto deve chamar AtaPortRegistryChannelSubKeyWrite durante a rotina de AtaChannelInitRoutine ou a rotina de IdeHwControl O driver de miniporto não pode chamar AtaPortRegistryChannelSubKeyWrite de qualquer outra rotina sem retornar false. Além disso, o driver de miniporto só pode chamar AtaPortRegistryChannelSubKeyWrite de sua rotina deIdeHwControlse 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
AtaPortRegistryChannelSubKeyRead