Função AtaPortRegistryChannelSubkeyWriteDeferred (irb.h)

Artigo
02/29/2024

A rotina AtaPortRegistryChannelSubKeyWriteDeferred grava dados de forma assíncrona no nome do valor indicado na chave HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelMdo Registro , em que N é o número do controlador e M é o número do canal.

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

Sintaxe

BOOLEAN AtaPortRegistryChannelSubkeyWriteDeferred(
  [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	Um terminado em nulo. Cadeia de caracteres Unicode.

[in] Buffer

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 por Length será atualizado para o comprimento dos dados que foram gravados com êxito no registro.

Retornar valor

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

Comentários

Se o nome do valor não estiver presente, AtaPortRegistryChannelSubKeyWriteDeferred 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 pode chamar AtaPortRegistryChannelSubKeyWriteDeferred de qualquer uma das rotinas de chave que pertencem à interface de canal.

O driver de miniporto não deve reutilizar o buffer apontado pelo Buffer após a chamada inicial para AtaPortRegistryChannelSubKeyWriteDeferred. Como a chamada é assíncrona, o buffer ainda pode apontar para dados que não foram liberados para o registro. O driver de porta libera os dados no buffer para o registro quando o driver de miniporto chama AtaPortRegistryFreeBuffer.

Requisitos

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

Confira também

AtaPortRegistryAllocateBuffer

AtaPortRegistryFreeBuffer

Compartilhar via