GdiplusShutdown 関数 (gdiplusinit.h)

GdiplusShutdown 関数は、Windows GDI+ で使用されるリソースをクリーンアップします。 GdiplusStartup の各呼び出しは、GdiplusShutdown の呼び出しとペアにする必要があります。

構文

void GdiplusShutdown(
  ULONG_PTR token
);

パラメーター

token

種類: [入力] ULONG_PTR

GdiplusStartup の以前の呼び出しによって返されたトークン。

戻り値

なし

解説

GDI+ オブジェクトを作成する前に GdiplusStartup を呼び出す必要があります。 GdiplusShutdown を呼び出す前に、GDI+ オブジェクトをすべて削除する (またはスコープ外に移動させる) 必要があります。

メモ Windows 7 以前の場合、GDI+ でフォント ファミリを作成できない場合は、汎用 Sans Serif ファミリに代わり、クライアント側では汎用ファミリのポインターがキャッシュされます。 GdiplusStartup と GdiplusShutdown の呼び出しはこのキャッシュを認識しないため、オペレーティング システムはオブジェクトの有効期間を過ぎた汎用ファミリ オブジェクトのポインターを保持するため、オペレーティング システムがクラッシュします。 Windows 8 以降では、GDI+ は汎用ファミリ オブジェクトの sentinel 値を返します。この値は 、GdiplusStartup と GdiplusShutdown の呼び出しで一定のままであるため、オペレーティング システムはオブジェクトの有効期間を過ぎた汎用ファミリ オブジェクトのポインターを保持しません。

 

例

GdiplusStartup と GdiplusShutdown の呼び出しの例については、「GdiplusStartup」を参照してください。

要件

サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusinit.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

関連項目

GdiplusStartup

GdiplusStartupInput

GdiplusStartupOutput

はじめに