Partilhar via


/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

  1. 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.

  2. Selecione a página de propriedades Propriedades da Configuração>Vinculador>Sistema.

  3. 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.

Confira também

Opções do EDITBIN
Opções de vinculador MSVC