Partilhar via


_aligned_msize

Retorna o tamanho de um bloco de memória alocado no heap.

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

Parâmetros

  • [entrada] memblock
    Ponteiro para o bloco de memória.

  • [entrada] alignment
    O valor de alinhamento, que deve ser uma potência de inteiro de 2.

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

Valor de retorno

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

Comentários

A função de _aligned_msize retorna o tamanho, em bytes, do bloco de memória alocado por uma chamada a _aligned_malloc ou a _aligned_realloc. Os valores de alignment e de offset devem ser iguais aos valores passados para a função que alocou o bloco.

Quando o aplicativo é vinculado a uma versão de depuração das bibliotecas de tempo de execução C, _aligned_msize resolve a _aligned_msize_dbg. Para obter mais informações sobre como o heap é gerenciado durante o processo de depuração, consulte O heap de depuração do CRT.

Essa função valida seu parâmetro. Se memblock for um ponteiro nulo ou alignment não é uma potência de 2, _msize invoca um manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se o erro é tratado, a função errno define a EINVAL e retorna -1.

Requisitos

Rotina

Cabeçalho necessário

_msize

<malloc.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Bibliotecas

Todas as versões das Bibliotecas em tempo de execução C.

Equivalência do .NET Framework

Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.

Consulte também

Referência

Alocação de memória