APIENTRY

APIENTRY

	tulio    Member since: 5/20/2004  From: Brazil
	Posted - 4/19/2006 1:34:47 PM
Hi, I am trying to understand some C/C++ constructions, hope anyone can help me in some simple questions. First of all, in a function prototype like this: #ifdef __cplusplus extern "C" { #endif extern int APIENTRY pngLoadRaw(const char *filename, pngRawInfo *rawinfo); #ifdef __cplusplus } #endif For example. Why the extern "C" in the #ifdef __cplusplus directive? I know it is commonly used in C++ classes when C code is used. And what the APIENTRY keyword means? It is compile specific, is it in the C++ language? it seems to map to __stdcall. Where can I find more information about: __stdcall, __cdecl, __clrcall, etc... Thanks and sorry for the silly questions
User Rating: 1010   |  Rate This User  Report this Post to a Moderator | Link

	Colin Jeanne    Member since: 8/13/2001  From: Bellevue, WA, United StatesGDNet+
	Posted - 4/19/2006 1:39:23 PM
The Win32 API was written using C not C++. This bring with it a few differences. The important difference in this case is the way that function arguments are passed onto the stack and who is responsible for cleaning the stack when the function returns. This is where __stdcall, __cdecl, __clrcall, __thiscall, etc. come in. C uses the __stdcall convention while C++ uses __cdecl and __thiscall. MSDN on calling conventions APIENTRY and many other Win32-isms like CALLBACK and WINAPI specify the calling convention for the function. Less Than Enlightened
User Rating: 1660   |  Rate This User  Report this Post to a Moderator | Link

	Anon Mike    Member since: 2/7/2001
	Posted - 4/19/2006 7:16:25 PM
The extern C stuff is there so that if you are writing a C++ program you can still call win32 functions (which are written for C). APIENTRY is there because Windows uses the stdcall calling convention. However you are not required to use stdcall for your own app. Basically it's saying "regardless of whatever convention you use internally, when calling this specific function you have to use stdcall".
User Rating: 1604   |  Rate This User