Função AtaPortRegistryControllerKeyWrite (irb.h)
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.
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) |