_aligned_offset_malloc_dbg

Aloca memória em um limite de alinhamento especificado (somente versão de depuração).

Sintaxe

void * _aligned_offset_malloc_dbg(
   size_t size,
   size_t alignment,
   size_t offset,
   const char *filename,
   int linenumber
);

Parâmetros

size
Tamanho da alocação de memória solicitada.

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.

filename
Ponteiro para o nome do arquivo de origem que solicitou a operação de alocação ou NULL.

linenumber
Número da linha no arquivo de origem em que a operação de alocação foi solicitada ou NULL.

Valor retornado

Um ponteiro para o bloco de memória alocado ou NULL, se a operação tiver falhado.

Comentários

_aligned_offset_malloc_dbg é uma versão de depuração da _aligned_offset_malloc função. Quando _DEBUG não estiver definido, cada chamada para _aligned_offset_malloc_dbg é reduzida a uma chamada para _aligned_offset_malloc. _aligned_offset_malloc e _aligned_offset_malloc_dbg alocam um bloco de memória no heap de base, mas _aligned_offset_malloc_dbg oferece vários recursos de depuração: buffers nos dois lados da parte do usuário do bloco para testar se há perdas e informações de filename/linenumber para determinar a origem das solicitações de alocação. O acompanhamento de tipos de alocação específicos com um parâmetro de tipo de bloco não é um recurso de depuração compatível com alocações alinhadas. As alocações alinhadas aparecerão como um tipo de _NORMAL_BLOCK bloco.

_aligned_offset_malloc_dbg aloca o bloco de memória com um pouco mais de espaço que o size solicitado. O espaço extra é usado pelo gerenciador de heap de depuração para vincular os blocos de memória de depuração e fornecer ao aplicativo informações de cabeçalho de depuração e buffers de substituição. Quando o bloco é alocado, a parte do usuário do bloco é preenchida com o valor 0xCD e cada um dos buffers de substituição é preenchido com 0xFD.

_aligned_offset_malloc_dbg é útil em situações em que o alinhamento é necessário em um elemento aninhado. Por exemplo, se o alinhamento foi necessário em uma classe aninhada.

_aligned_offset_malloc_dbg é baseado em malloc; para obter mais informações, consulte malloc.

Essa função define errno como ENOMEM se a alocação da memória tiver falhado ou se o tamanho solicitado for maior que _HEAP_MAXREQ. Para obter mais informações sobre errno, consulte errno, _doserrno, _sys_errlist e _sys_nerr. Além disso, _aligned_offset_malloc valida seus parâmetros. Se alignment não for uma potência de 2 ou se offset for diferente de zero e maior ou igual a size, essa função invocará o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essa função retornará NULL e definirá errno como EINVAL.

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.

Requisitos

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

Rotinas de depuração