nl::Weave::System::PacketBuffer

Incrementar a contagem de referência do buffer atual.

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

Alinha o payload do buffer no limite de bytes especificado.

Mover o payload do buffer adiante, se necessário.

Retorna o tamanho da alocação, incluindo os espaços de dados reservados e de payload, mas sem incluir o espaço alocado para a estrutura PacketBuffer.

Descubra o número de bytes de dados que podem ser adicionados ao buffer atual de acordo com a posição inicial e o comprimento dos dados atuais.

Mover os dados dos buffers subsequentes na cadeia para o buffer atual até que ele esteja completo.

Somente o buffer atual é compactado: os dados no 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 integralmente para o buffer atual, ele será removido da cadeia e liberado. O método não tem 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 pelo buffer atual e seguindo pelos buffers restantes na cadeia. Cada buffer completamente consumido é liberado e a função retorna o primeiro buffer (se houver) contendo os dados restantes. O buffer atual precisa ser o cabeçalho da cadeia do buffer.

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

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 de acordo com a quantidade consumida.

Recebe o tamanho, em bytes, dos dados no buffer de pacote.

Remover o buffer atual da cadeia e retornar um ponteiro para os buffers restantes.

O buffer atual precisa ser o cabeçalho da cadeia.

Verifique se o buffer tem pelo menos a quantidade especificada de espaço reservado.

Verifique se o buffer tem pelo menos a quantidade especificada de espaço reservado, movendo os dados no buffer para a frente, a fim de liberar espaço, se necessário.

Encontra a quantidade máxima, em bytes, de dados que caberá no buffer de acordo com a posição inicial e o tamanho do buffer atuais.

Recebe o ponteiro para o próximo buffer na cadeia.

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

Define o tamanho, 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 adequadamente. Quando o buffer não é o topo da cadeia do buffer (caso comum: o autor da chamada adiciona dados ao último buffer na cadeia do PacketBuffer antes de chamar camadas superiores), o aChainHead precisa ser transmitido para ajustar corretamente o comprimento total de cada buffer à frente do buffer atual.

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

Recebe o ponteiro para o início dos dados no buffer.

Recebe o comprimento total dos dados do pacote na cadeia do buffer.

Liberar todos os buffers de pacote em uma cadeia.

Diminuir 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 para os pools de alocação, conforme apropriado. Como regra, os usuários precisam tratar esse método como um equivalente da função free() e não usar o argumento após a chamada.

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

* @note When the buffer chain is referenced by multiple callers,FreeHead()` vai remover o cabeçalho, mas não forçará a desalocação dele.

Aloca um único PacketBuffer do tamanho máximo padrão (WEAVE_SYSTEM_CONFIG_PACKETBUFFER_CAPACITY_MAX) com o tamanho reservado padrão (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE) no payload.

O tamanho reservado (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE) é grande o suficiente para armazenar cabeçalhos da camada de transporte, além dos cabeçalhos exigidos por WeaveMessageLayer e WeaveExchangeLayer.

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

O parâmetro transmitido é o tamanho reservado antes do payload para acomodar cabeçalhos de pacotes de diferentes camadas de 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, especificado na chamada.

• PacketBuffer::New(0) : quando chamado dessa maneira, o buffer é retornado sem nenhum cabeçalho reservado. Consequentemente, todo o payload pode ser usado pelo autor da chamada. Esse padrão é particularmente útil nas camadas inferiores das pilhas de rede, nos casos em que o usuário sabe que o payload será copiado para a mensagem final com reservas de cabeçalho apropriadas ou na criação de PacketBuffer que são anexados a uma cadeia de PacketBuffer via PacketBuffer::AddToEnd(). Parâmetros

  [in] aReservedSize

  de espaço do cabeçalho para reservar.

  Retorna
  Em caso de sucesso, um ponteiro para o PacketBuffer, na falha NULL.

Aloca um PacketBuffer com o tamanho reservado padrão (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE) no payload 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 na alocação de um PacketBuffer para uma mensagem da camada do aplicativo.

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

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

Essa função é um ambiente autônomo para soquetes.