/Gs (contrôler les appels de contrôle de pile)

Mise à jour : novembre 2007

Gère les tests de pile.

/Gs[size]

Arguments

  • size
    (facultatif) Nombre d'octets que les variables locales peuvent occuper avant qu'un test de pile ne soit activé.

Notes

Cette option est une fonctionnalité avancée qui permet de contrôler les tests de pile. Un test de pile est une séquence de code que le compilateur insère dans chaque appel de fonction. Lorsqu'il est activé, le test de pile accède de manière bénigne à la mémoire selon la quantité d'espace requise pour stocker les variables locales de la fonction associée.

Si une fonction requiert plus de size octets d'espace sur la pile pour les variables locales, le test de pile correspondant est activé. La valeur par défaut de size est la taille d'une page :

  • 4 Ko pour x86

  • 4 Ko pour x64

  • 8 Ko pour Itanium

Cette valeur permet à une application et au gestionnaire de mémoire Windows d'augmenter la quantité de mémoire allouée à la pile du programme au moment de l'exécution.

Remarque :

La valeur par défaut de size permet à la pile du programme d'applications pour Windows de s'accroître correctement au moment de l'exécution. Ne modifiez le paramètre par défaut de /Gs que si vous savez exactement pourquoi vous devez le modifier.

Certains programmes, tels que les pilotes de périphériques virtuels, n'ont pas besoin de ce mécanisme de croissance de la pile par défaut. En ces cas, les tests de pile ne sont pas nécessaires. Vous pouvez indiquer au compilateur de ne pas générer de test de pile en attribuant à size une valeur supérieure à celle qui peut être exigée par une fonction quelconque pour le stockage de variables locales. Aucun espace n'est autorisé entre /Gs et size.

/Gs0 équivaut à /Ge (Activer les tests de pile).

Vous pouvez activer et désactiver les tests de pile en utilisant check_stack. Notez que l'option /Gs et le pragma check_stack n'ont aucun effet sur les routines de la bibliothèque C standard ; ils affectent uniquement les fonctions que vous compilez.

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d'informations, consultez Comment : ouvrir les pages de propriétés d'un projet.

  2. Cliquez sur le dossier C/C++.

  3. Cliquez sur la page de propriétés Ligne de commande.

  4. Spécifiez l'option du compilateur dans la zone Options supplémentaires.

Pour définir cette option du compilateur par programme

Voir aussi

Référence

Options du compilateur

Définition des options du compilateur