Skip to content

Latest commit

 

History

History
80 lines (64 loc) · 3.6 KB

nf-gdiplusinit-gdiplusshutdown.md

File metadata and controls

80 lines (64 loc) · 3.6 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist req.product ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:gdiplusinit.GdiplusShutdown
GdiplusShutdown function (gdiplusinit.h)
The GdiplusShutdown function cleans up resources used by Windows GDI+. Each call to GdiplusStartup should be paired with a call to GdiplusShutdown.
GdiplusShutdown
GdiplusShutdown function [GDI+]
_gdiplus_FUNC_GdiplusShutdown_
gdiplus._gdiplus_FUNC_GdiplusShutdown_
gdiplusinit/GdiplusShutdown
gdiplus\_gdiplus_FUNC_GdiplusShutdown_.htm
gdiplus
VS|gdicpp|~\gdiplus\gdiplusreference\functions\gdiplusshutdown.htm
12/05/2018
GdiplusShutdown, GdiplusShutdown function [GDI+], _gdiplus_FUNC_GdiplusShutdown_, gdiplus._gdiplus_FUNC_GdiplusShutdown_, gdiplusinit/GdiplusShutdown
gdiplusinit.h
Gdiplus.h
Windows
Windows XP, Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Gdiplus.lib
Gdiplus.dll
Windows
GDI+ 1.0
19H1
GdiplusShutdown
gdiplusinit/GdiplusShutdown
c++
APIRef
kbSyntax
DllExport
Gdiplus.dll
GdiplusShutdown

-description

The GdiplusShutdown function cleans up resources used by Windows GDI+. Each call to GdiplusStartup should be paired with a call to GdiplusShutdown.

-parameters

-param token

Type: [in] ULONG_PTR

Token returned by a previous call to GdiplusStartup.

-remarks

You must call GdiplusStartup before you create any GDI+ objects, and you must delete all of your GDI+ objects (or have them go out of scope) before you call GdiplusShutdown.

Note  For Windows 7 and earlier, if GDI+ can't create a font family, it substitutes the generic Sans Serif family and client-side caches the pointer for the generic family. Because calls to GdiplusStartup and GdiplusShutdown are not aware of this caching, the operating system retains the pointer for the generic family object past the object's lifetime, which causes the operating system to crash. For Windows 8 and later, GDI+ returns a sentinel value for the generic family object that remains constant across calls to GdiplusStartup and GdiplusShutdown so the operating system doesn't retain the pointer for the generic family object past the object's lifetime.
 

Examples

For an example of calling GdiplusStartup and GdiplusShutdown, see GdiplusStartup.

-see-also

GdiplusStartup

GdiplusStartupInput

GdiplusStartupOutput

Getting Started