Structure GdiplusStartupInput (gdiplusinit.h)

  • Article

La structure GdiplusStartupInput contient un bloc d’arguments requis par la fonction GdiplusStartup .

Syntaxe

struct GdiplusStartupInput {
  UINT32         GdiplusVersion;
  DebugEventProc DebugEventCallback;
  BOOL           SuppressBackgroundThread;
  BOOL           SuppressExternalCodecs;
  void           GdiplusStartupInput(
    DebugEventProc debugEventCallback,
    BOOL           suppressBackgroundThread,
    BOOL           suppressExternalCodecs
  );
};

Membres

GdiplusVersion

Type : UINT32

Spécifie la version de GDI+. Doit être égal à 1.

DebugEventCallback

Type : DebugEventProc

Pointeur vers une fonction de rappel que GDI+ peut appeler, sur les builds de débogage, pour les assertions et les avertissements. La valeur par défaut est NULL.

SuppressBackgroundThread

Type : BOOL

Valeur booléenne qui spécifie s’il faut supprimer le thread d’arrière-plan GDI+. Si vous définissez ce membre sur TRUE, GdiplusStartup retourne (dans son paramètre de sortie ) un pointeur vers une fonction de raccordement et un pointeur vers une fonction de démarrage. Vous devez appeler ces fonctions de manière appropriée pour remplacer le thread d’arrière-plan. Si vous ne souhaitez pas être responsable de l’appel des fonctions de hook et de décrochage, définissez ce membre sur FALSE. La valeur par défaut est FALSE.

SuppressExternalCodecs

Type : BOOL

Valeur booléenne qui spécifie si vous souhaitez que GDI+ supprime les codecs d’image externes. GDI+ version 1.0 ne prend pas en charge les codecs d’image externes. Ce champ est donc ignoré. La valeur par défaut est FALSE.

void GdiplusStartupInput( DebugEventProc debugEventCallback, BOOL suppressBackgroundThread, BOOL suppressExternalCodecs)

Constructeur pour la structure GdiplusStartupInput .

Le constructeur définit le membre GdiplusVersion sur 1. Tous les paramètres du constructeur étant facultatifs, vous pouvez déclarer une variable de type GdiplusStartupInput sans transmettre d’arguments au constructeur, et tous les membres sont initialisés avec les valeurs par défaut appropriées.

Notes

La structure GdiplusStartupInput fournit un constructeur qui définit le membre GdiplusVersion sur 1 et vous permet de spécifier des valeurs pour les trois autres membres. Tous les paramètres du constructeur étant facultatifs, vous pouvez déclarer une variable de type GdiplusStartupInput sans transmettre d’arguments au constructeur, et tous les membres sont initialisés avec les valeurs par défaut appropriées.

Si vous définissez le membre SuppressBackgroundThread sur TRUE dans le paramètre d’entrée de GdiplusStartup, vous devez appeler les fonctions de hook et de déhook retournées dans le paramètre de sortie retourné par cette fonction. Appelez ces fonctions avant et après la boucle de message main de l’application, c’est-à-dire une boucle de message active pendant toute la durée de vie de GDI+. Appelez la fonction hook avant le début de la boucle, puis appelez la fonction de déhook une fois la boucle terminée.

Configuration requise

   
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête gdiplusinit.h (include gdiplus.h)

Voir aussi

  • [GdiplusShutdown] ((windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
  • GdiplusStartup
  • [GdiplusStartupOutput] ((windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
  • Bien démarrer