GdiplusStartupOutput-Struktur (gdiplusinit.h)

Artikel
08/24/2023

Die GdiplusStartup-Funktion verwendet die GdiplusStartupOutput-Struktur , um (in ihrem Ausgabeparameter ) einen Zeiger auf eine Hookfunktion und einen Zeiger auf eine Unhookfunktion zurückzugeben. Wenn Sie den SuppressBackgroundThread-Member des Eingabeparameters auf TRUE festlegen, sind Sie dafür verantwortlich, diese Funktionen aufzurufen, um den Windows GDI+-Hintergrundthread zu ersetzen.

Rufen Sie die Hook- und Unhook-Funktionen vor und nach der Standard-Nachrichtenschleife der Anwendung auf, d. h. eine Nachrichtenschleife, die für die Lebensdauer von GDI+ aktiv ist. Rufen Sie die Hookfunktion auf, bevor die Schleife gestartet wird, und rufen Sie die Unhookfunktion auf, nachdem die Schleife endet. Der Tokenparameter der Hookfunktion empfängt einen Bezeichner, den Sie später an die Unhook-Funktion übergeben sollten. Wenn Sie den richtigen Bezeichner (den von der Hookfunktion zurückgegebenen) nicht an die Unhook-Funktion übergeben, kommt es zu Ressourcenlecks, die erst bereinigt werden, wenn der Prozess beendet wird.

Wenn Sie nicht für den Aufruf der Hook- und Unhook-Funktionen verantwortlich sein möchten, legen Sie den SuppressBackgroundThread-Member des Eingabeparameters (übergeben an GdiplusStartup) auf FALSE fest.

Syntax

struct GdiplusStartupOutput {
  NotificationHookProc   NotificationHook;
  NotificationUnhookProc NotificationUnhook;
};

Members

NotificationHook

Typ: NotificationHookProc

Empfängt einen Zeiger auf eine Hookfunktion.

NotificationUnhook

Typ: NotificationUnhookProc

Empfängt einen Zeiger auf eine Unhookfunktion.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	gdiplusinit.h (include Gdiplus.h)

Weitere Informationen