nl :: Tecer:: Sistema:: PacketBuffer

Aumente a contagem de referência do buffer atual.

Adicione o buffer de pacote fornecido ao final da cadeia de buffer, ajustando o comprimento total de cada buffer na cadeia de acordo.

Alinha a carga útil do buffer no limite de bytes especificado.

Movendo a carga útil no buffer para frente, se necessário.

Retorne o tamanho da alocação incluindo os espaços de dados reservados e de carga útil, mas não incluindo o espaço alocado para a estrutura PacketBuffer .

Obtenha o número de bytes de dados que podem ser adicionados ao buffer atual, considerando a posição inicial atual e o comprimento dos dados.

Mova os dados dos buffers subsequentes na cadeia para o buffer atual até que esteja cheio.

Apenas o buffer atual é compactado: os dados dentro do buffer atual são movidos para a frente do buffer, eliminando qualquer espaço reservado. O espaço disponível restante é preenchido com dados movidos de buffers subsequentes na cadeia, até que o buffer atual esteja cheio. Se um buffer subsequente na cadeia for movido para o buffer atual em sua totalidade, ele será removido da cadeia e liberado. O método não aceita parâmetros, não retorna resultados e não pode falhar.

Consumir dados em uma cadeia de buffers.

Consumir dados em uma cadeia de buffers, começando com o buffer atual e continuando pelos buffers restantes na cadeia. Cada buffer que é completamente consumido é liberado e a função retorna o primeiro buffer (se houver) contendo os dados restantes. O buffer atual deve ser o chefe da cadeia de buffer.

Ajuste o buffer atual para indicar a quantidade de dados consumidos.

Avança a posição inicial dos dados no buffer atual pela quantidade especificada, em bytes, até o comprimento dos dados no buffer. Diminua o comprimento e o comprimento total pela quantidade consumida.

Obtenha o comprimento, em bytes, dos dados no buffer de pacotes.

Desanexe o buffer atual de sua cadeia e retorne um ponteiro para os buffers restantes.

O buffer atual deve ser o chefe da cadeia.

Certifique-se de que o buffer tenha pelo menos a quantidade especificada de espaço reservado.

Certifique-se de que o buffer tenha pelo menos a quantidade especificada de espaço reservado, movendo os dados no buffer para frente para liberar espaço, se necessário.

Obtenha a quantidade máxima, em bytes, de dados que caberão no buffer, considerando a posição inicial atual e o tamanho do buffer.

Obtém o ponteiro para o próximo buffer na cadeia.

Obtenha o número de bytes dentro do buffer atual entre o início do buffer e a posição inicial dos dados atuais.

Defina o comprimento, em bytes, dos dados no buffer, ajustando o comprimento total de acordo.

A função define o comprimento, em bytes, dos dados no buffer, ajustando o comprimento total apropriadamente. Quando o buffer não é o chefe da cadeia de buffer (caso comum: o chamador adiciona dados ao último buffer na cadeia PacketBuffer antes de chamar camadas superiores), o aChainHead deve ser passado para ajustar adequadamente os comprimentos totais de cada buffer à frente do buffer atual.

Defina os dados iniciais no buffer, ajustando o comprimento e o comprimento total de acordo.

Obtém o ponteiro para o início dos dados no buffer.

Obtenha o comprimento total dos dados do pacote na cadeia de buffer.

Libere todos os buffers de pacotes em uma cadeia.

Diminua a contagem de referência para todos os buffers na cadeia atual. Se a contagem de referência chegar a 0, os respectivos buffers serão liberados ou retornados aos pools de alocação, conforme apropriado. Como regra, os usuários devem tratar esse método como um equivalente da função free() e não usar o argumento após a chamada.

Libere o primeiro buffer em uma cadeia, retornando um ponteiro para os buffers restantes.

* @note When the buffer chain is referenced by multiple callers, FreeHead () `desanexará o cabeçalho, mas não desalocará o buffer principal à força.

Aloca um único PacketBuffer de tamanho máximo padrão ( WEAVE_SYSTEM_CONFIG_PACKETBUFFER_CAPACITY_MAX ) com tamanho reservado padrão ( WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE ) na carga útil.

O tamanho reservado ( WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE ) é grande o suficiente para conter cabeçalhos da camada de transporte, bem como cabeçalhos exigidos por WeaveMessageLayer e WeaveExchangeLayer .

Aloca um único PacketBuffer de tamanho total máximo com um tamanho de reserva de cabeçalho específico.

O parâmetro passado é o tamanho reservado antes da carga útil para acomodar cabeçalhos de pacote de diferentes camadas da pilha, não o tamanho geral do buffer a ser alocado. O tamanho do buffer WEAVE_SYSTEM_CONFIG_PACKETBUFFER_CAPACITY_MAX e não, especificado na chamada.

• PacketBuffer::New(0) : quando chamado desta forma, o buffer será retornado sem nenhum cabeçalho reservado, conseqüentemente toda a carga útil é utilizável pelo chamador. Este padrão é particularmente útil nas camadas inferiores de pilhas de rede, nos casos em que o usuário sabe que a carga útil será copiada para a mensagem final com reservas de cabeçalho apropriadas ou na criação de PacketBuffer anexado a uma cadeia de PacketBuffer via PacketBuffer::AddToEnd() . Parâmetros

  [in] aReservedSize

  quantidade de espaço do cabeçalho a ser reservada.

  Devoluções
  Em caso de sucesso, um ponteiro para o PacketBuffer , em caso de falha NULL .

Aloca um PacketBuffer com tamanho reservado padrão ( WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE ) na carga útil para cabeçalhos e pelo menos aAllocSize bytes de espaço para dados adicionais após o ponteiro do cursor inicial.

Esse uso é mais apropriado ao alocar um PacketBuffer para uma mensagem da camada de aplicativo.

Aloca um objeto PacketBuffer com pelo menos aReservedSize bytes reservados na carga útil para cabeçalhos e pelo menos aAllocSize bytes de espaço para dados adicionais após o ponteiro do cursor inicial.

Copie o buffer fornecido para um buffer de tamanho correto, se aplicável.

Esta função não funciona para sockets.