Função AtaPortRegistryControllerKeyWriteDeferred (irb.h)

Artigo
02/07/2025

A rotina de AtaPortRegistryControllerKeyWriteDeferred grava os dados de forma assíncrona no nome do valor indicado no HKLM\CurrentControlSet\Services\<service name>\ControllerNde chave do Registro, 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 AtaPortRegistryControllerKeyWriteDeferred(
  [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 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 pelo Length será atualizado para o comprimento dos dados que foram copiados com êxito para o registro.

Valor de retorno

AtaPortRegistryControllerKeyWriteDeferred retornará verdadeiro 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, a rotina AtaPortRegistryControllerKeyWriteDeferred criará uma entrada para o nome do valor e armazenará os dados de entrada no nome do valor recém-criado.

O driver de miniporto pode chamar o AtaPortRegistryControllerKeyWriteDeferred rotina de qualquer uma das rotinas definidas na interface do canal.

O buffer apontado por buffer deve ser alocado usando AtaPortRegistryAllocateBuffer. O driver de miniporto não deve reutilizar esse buffer depois de chamar AtaPortRegistryControllerKeyWriteDeferred porque o driver de porta atrasa a gravação dos dados da chave. Se o driver de miniporto reutilizar o buffer, ele poderá substituir os dados no buffer antes que o driver de porta tenha a oportunidade de armazená-los na chave do Registro. O driver de porta libera o buffer quando o driver de miniporto chama AtaPortRegistryFreeBuffer para liberar o buffer.

Requisitos

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

Consulte também

AtaPortRegistryAllocateBuffer

AtaPortRegistryFreeBuffer

Compartilhar via