I have been searching and I still am not sure what VKAPI_ATTR
and VKAPI_CALL
are. I am not sure if they are suppose to be a macro or some fancy C++ function declaration I am not aware of.
What is VKAPI_ATTR void VKAPI_CALL vkCommand(void)
offering that void vkCommand(void)
doesn't offer?
They are macros to make sure the correct calling convention is applied. This is less important in 64 bit where they have mostly converged but in 32 bit there are several incompatible ones.
Unfortunately different compilers have different ways of doing that. One puts the required token before the return value the other puts it after.
So the header uses both to make sure it can cover all bases.
They are defined in vk_platform.h.
They are C preprocessor macros that expand to platform-dependent (and often compiler-specific) function attributes.
The spec defines what they are supposed to do.
But basically each of VKAPI_ATTR
, VKAPI_CALL
and VKAPI_PTR
is distiguished by the spot it has to be in the function declaration to satisfy the C (potentially compiler-dependent) syntax.
Their value(s) are things like the chosen calling convention (e.g. __stdcall
) for the platform (detected at compile time).