Refactor: libpacemaker: clarify pointer arguments for internal scheduler APIs

Mark as [in,out] or const where appropriate. This is not comprehensive but
focuses on functions with doxygen blocks.