Refactor: libpe_status: clarify pointer arguments in headers

Ensure doxygen blocks use [in] or [in,out] as appropriate for pointer
arguments.

This is not comprehensive but focuses on functions that have doxygen blocks
in headers under include/.