DTC_APPEND

Insere um ou mais blocos de dados em uma cache de dados — um vetor do tipo INT mantido em memória como uma fila de blocos —, anexando BLOCKS blocos de IN_CACHE ao final de OUT_CACHE. É uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

             DTC_APPEND
         +-----------------+
UINT ----|BLOCKS           |
         |                 |
 INT ----|IN_CACHE         |
         |                 |
 INT ----|OUT_CACHE ------ |----
         +-----------------+

A função transfere BLOCKS blocos de dados presentes em IN_CACHE para o final da cache OUT_CACHE, preservando a ordem da fila. O valor retornado é um código de retorno que indica o sucesso ou a falha da operação.

Parâmetros

Nome	Direção	Tipo	Dimensão	Padrão	Faixa / Unidade	Descrição
BLOCKS	IN	UINT	—	0	—	Número de blocos de dados a serem transferidos.
IN_CACHE	IN	INT	[*]	—	—	Bloco de dados a ser inserido na cache.
OUT_CACHE	IN_OUT	INT	[*]	—	—	Cache de dados que recebe o bloco, mantida em memória como uma fila.

Códigos de retorno

A função retorna um valor do tipo INT (código de retorno). Use os identificadores com o namespace HILS (ex.: HILS.RE_FIL_OVF). Códigos mais comuns desta função:

Código	Identificador	Significado
0	SUCCESS	Bloco(s) inserido(s) na cache com sucesso.
5	GL_INV_PAR	Parâmetro inválido: tipo de dado inválido (ex.: estrutura) ou não suportado (ex.: WSTRING), índice inicial do vetor inválido ou quantidade de elementos do vetor inválida.
28	RE_FIL_OVF	Número de mensagens disponíveis na cache insuficiente para inserir o bloco.

Lista completa dos códigos de retorno: RET_CODE - Códigos de retorno do firmware G5.

Retorno / Saídas

INT — código de retorno. Retorna 0 (SUCCESS) quando a função é executada com sucesso; valor diferente de 0 indica falha (ver Códigos de retorno).

Observações

• OUT_CACHE é mantida em memória como uma fila dos blocos de dados inseridos. Para mais informações sobre a estrutura da cache consulte Estrutura da cache (CACHE).

Ver também

DTC_PUSH, DTC_REMOVE, DTC_MAN