_aligned_free_dbg
Libera um bloco de memória alocado com _aligned_malloc ou _aligned_offset_malloc (apenas depuração).
void _aligned_free_dbg( void *memblock );
Parâmetros
- memblock
Um ponteiro para o bloco de memória que foi retornado para a função _aligned_malloc ou _aligned_offset_malloc.
Comentários
A função _aligned_free_dbg é uma versão de depuração da função _aligned_free. Quando _DEBUG não está definido, cada chamada a _aligned_free_dbg é reduzida a uma chamada a _aligned_free. O _aligned_free e o _aligned_free_dbg liberam um bloco de memória no heap de base, mas o _aligned_free_dbg acomoda um recurso de depuração: a habilidade de manter blocos liberados na lista vinculada do heap para simular condições de baixa memória.
O _aligned_free_dbg realiza uma verificação de validade em todos os arquivos e locais de bloco especificados antes de realizar a ação de liberação. O aplicativo não deve fornecer essas informações. Ao liberar um bloco de memória, o gerenciador de heap de depuração verifica automaticamente a integridade dos buffers nos dois lados da parte do usuário e emite um relatório de erro se tiver ocorrido substituição. Se o campo de bit _CRTDBG_DELAY_FREE_MEM_DF do sinalizador _crtDbgFlag estiver definido, o bloco liberado é preenchido com o valor 0xDD, atribuído ao tipo de bloco _FREE_BLOCK e mantido na lista de blocos de memória vinculada do heap.
Se ocorrer um erro ao liberar a memória, o errno é definido com informações do sistema operacional sobre a natureza da falha. Para obter mais informações, consulte errno, _doserrno, _sys_errlist e _sys_nerr.
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 de base, consulte Detalhes da pilha de depuração CRT. Para obter informações sobre os tipos de blocos de alocação e como eles são usados, consulte Tipos de blocos na heap de depuração. Para obter informações sobre as diferenças entre chamar uma função heap padrão e sua versão de depuração em uma compilação de depuração de um aplicativo, consulte Versões de depuração das funções de alocação da pilha.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_aligned_free_dbg |
<crtdbg.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.
Equivalência do .NET Framework
Não aplicável. Para chamar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.