nl::Weave::System::PacketBuffer

Incrementa a contagem de referência do buffer atual.

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

Alinha o payload do buffer no limite de bytes especificado.

Mover o payload no buffer para frente, 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.

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

Move dados de buffers subsequentes na cadeia para o buffer atual até que ele esteja cheio.

Somente o buffer atual é compactado: os dados nele 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 na íntegra, 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 avançando 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 líder da cadeia do buffer.

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

A posição inicial dos dados no buffer atual é avançada pelo valor especificado, 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 líder da cadeia.

Confira se o buffer tem 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 nele para frente a fim de liberar espaço, se necessário.

Extrai a quantidade máxima, em bytes, de dados que cabem no buffer, considerando a posição inicial e o tamanho atuais do buffer.

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

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

Define o comprimento, em bytes, dos dados no buffer, ajustando o comprimento total conforme necessário.

A função define o comprimento, em bytes, dos dados no buffer, ajustando o comprimento total adequadamente. Quando o buffer não é o líder da cadeia de buffers (caso comum: o autor da chamada adiciona dados ao último buffer na cadeia PacketBuffer antes de chamar camadas mais altas), o aChainHead precisa ser transmitido para ajustar corretamente o comprimento total de cada buffer antes do buffer atual.

Defina os dados iniciais no buffer, ajustando a duração e o comprimento total adequadamente.

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

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

Liberar todos os buffers de pacote em uma cadeia.

Diminui 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 precisam tratar esse método como um equivalente da função free() e não usar o argumento após a chamada.

Liberar o primeiro buffer de uma cadeia, retornando um ponteiro para os buffers restantes.

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

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 e os exigidos por WeaveMessageLayer e WeaveExchangeLayer.

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

O parâmetro transmitido tem o tamanho reservado antes do payload para acomodar os cabeçalhos dos pacotes de diferentes camadas da pilha, e não o tamanho total 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 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 mais baixas de pilhas de rede, nos casos em que o usuário sabe que o payload será copiado na mensagem final com as reservas de cabeçalho adequadas ou na criação de PacketBuffer que são anexados a uma cadeia de PacketBuffer via PacketBuffer::AddToEnd(). Parâmetros

  [in] aReservedSize

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

  Retorna
  Em caso de sucesso, um ponteiro para o PacketBuffer, em caso de 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 depois do ponteiro inicial do cursor.

Esse uso é mais apropriado ao alocar um PacketBuffer para uma mensagem na 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 inicial do cursor.

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

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