/HEAP
Define o tamanho do heap em bytes. Essa opção se aplica apenas a arquivos executáveis.
Sintaxe
/HEAP:
reserve
[,
commit
]
Comentários
O argumento reserve
especifica a alocação total de heap inicial na memória virtual. O vinculador /HEAP
ou a opção EDITBIN arredonda o valor especificado para o múltiplo de 4 bytes mais próximo. Por padrão, o tamanho do heap é de 1 MB.
O argumento commit
opcional está sujeito à interpretação pelo sistema operacional. Em um sistema operacional Windows, ele especifica a quantidade inicial de memória física a ser alocada. Especifica também a quantidade excedente que deverá ser alocada quando o heap for expandido. A memória virtual confirmada faz com que o espaço seja reservado no arquivo de paginação. Um valor de commit
maior permite que o sistema aloque memória com menos frequência quando o aplicativo precisar de mais espaço de heap, mas aumenta os requisitos de memória e possivelmente a duração da inicialização do aplicativo. O valor de commit
deve ser menor ou igual ao valor de reserve
. O valor padrão é 4 KB.
Especifique os valores de reserve
e commit
em notação decimal, hexadecimal em linguagem C ou octal. Por exemplo, é possível especificar um valor de 1 MB como 1048576 em decimal, 0x100000 em hexadecimal ou 04000000 em octal. Os valores padrão são equivalentes à opção /HEAP:1048576,4096
.
Exemplo
Esse comando de link de exemplo cria um main.exe executável com reserva de heap de 2 MB. O heap inicial e as expansões de heap posteriores vêm em blocos de 64 KB:
link /heap:0x200000,0x10000 main.obj
Para definir essa opção do vinculador no Visual Studio
Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter mais informações, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.
Selecione a página de propriedades Propriedades da Configuração>Vinculador>Sistema.
Defina as propriedade Tamanho de Reserva do Heap e Tamanho de Confirmação de Heap e, em seguida, escolha OK ou Aplicar para salvar as alterações.