|
Syntax
Status GdiplusStartup(
ULONG_PTR token *token,
const GdiplusStartupInput *input,
GdiplusStartupOutput *output
);
PowerBASIC Syntax
DECLARE FUNCTION GdiplusStartup ( _
BYREF token AS DWORD _
BYREF pinput AS GdiplusStartupInput _
BYREF poutput AS GdiplusStartupOutput _
) AS LONG
Parameters
token
[out] Pointer to a ULONG_PTR that receives a token. Pass the token
to GdiplusShutdown when you have finished using GDI+.
input
[in] Pointer to a GdiplusStartupInput structure that contains the
GDI+ version, a pointer to a debug callback function, a Boolean value that
specifies whether to suppress the background thread, and a Boolean value
that specifies whether to suppress external image codecs.
output
[out] Pointer to a GdiplusStartupOutput structure that receives a
pointer to a notification hook function and a pointer to a notification
unhook function. If the SuppressBackgroundThread data member of the
input parameter is FALSE, then this parameter can be NULL.
Return Value
If the function succeeds, it returns Ok, which is an element of the
Status enumeration.
If the function fails, it returns one of the other elements of the
Status enumeration.
Remarks
You must call GdiplusStartup before you create any GDI+ objects,
and you must delete all of your GDI+ objects before you call GdiplusShutdown.
You can call GdiplusStartup on one thread and call
GdiplusShutdown on another thread as long as you delete all of your
GDI+ objects (or have them go out of scope) before you call
GdiplusShutdown.
Do not call GdiplusStartup or GdiplusShutdown in DllMain
or in any function that is called by DllMain. If you want to create
a dynamic-link library (DLL) that uses GDI+, you should use one of the
following techniques to initialize GDI+:
-
Require your clients to call GdiplusStartup before they call the
functions in your DLL and to call GdiplusShutdown when they have
finished using your DLL.
-
Export your own startup function that calls GdiplusStartup and
your own shutdown function that calls GdiplusShutdown. Require
your clients to call your startup function before they call other
functions in your DLL and to call your shutdown function when they have
finished using your DLL.
-
Call GdiplusStartup and GdiplusShutdown in each of your
functions that make GDI+ calls.
|
