_aligned_msize_dbg
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.
Valor retornado
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 estiver definido, cada chamada para _aligned_msize_dbg é reduzida a uma chamada para _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 uma potência de 2, _msize invocará um manipulador de parâmetro inválido, 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 do 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 as 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.