Compartilhar via

_aligned_msize_dbg

  • Artigo

Retorna o tamanho de um bloco de memória alocado no heap (somente versão de depuração).

Sintaxe

size_t _aligned_msize_dbg(
   void *memblock,
   size_t alignment,
   size_t offset
);

Parâmetros

memblock
Ponteiro para o bloco de memória.

alignment
O valor de alinhamento, que deve ser um inteiro elevado à segunda potência.

offset
O deslocamento na alocação de memória para forçar o alinhamento.

Retornar valor

Retorna o tamanho (em bytes) como um inteiro sem sinal.

Comentários

Os valores alignment e offset devem ser os mesmos que os valores passados para a função que alocou o bloco.

_aligned_msize_dbg é uma versão de depuração da _aligned_msize função. Quando _DEBUG não está definido, cada chamada para é reduzida a uma chamada para _aligned_msize_dbg_aligned_msize. _aligned_msize e _aligned_msize_dbg calculam o tamanho de um bloco de memória no heap de base, mas _aligned_msize_dbg adiciona um recurso de depuração: ele inclui os buffers nos dois lados da parte do usuário do bloco de memória no tamanho retornado.

Esta função valida seu parâmetro. Se memblock for um ponteiro nulo ou alignment não for um poder de 2, invocará um manipulador de parâmetros inválido, _msize conforme descrito em Validação de parâmetro. Se o erro for tratado, a função definirá errno como EINVAL e retornará –1.

Para obter informações sobre como os blocos de memória são alocados, inicializados e gerenciados na versão de depuração do heap base, consulte Detalhes do heap de depuração CRT. Para obter informações sobre os tipos de bloco de alocação e como eles são usados, consulte Tipos de blocos no heap de depuração. Para obter informações sobre as diferenças entre funções de heap padrão e suas versões de depuração, consulte Depurar versões de funções de alocação de heap.

Requisitos

Rotina Cabeçalho necessário
_aligned_msize_dbg <crtdbg.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Somente versões de depuração de bibliotecas de tempo de execução C.

Confira também

Alocação de memória