Move the closing markers in the '#define .. #endif' to match the opening
markers.

Tracked-On: projectacrn#8665
Signed-off-by: Haiwei Li <haiwei.li@intel.com>

This patch is to:
* Trim trailing whitespaces
* Use macro and add comments
* Add lock around `reset_one_vioapic()`

Tracked-On: projectacrn#8740
Signed-off-by: Haiwei Li <haiwei.li@intel.com>

GAI Tooling Notice: These contents may have been developed with support from one
or more generative artificial intelligence solutions.

This patch is to add doxygen style comments for some elements in
vp-dm_vioapic module.

Tracked-On: projectacrn#8665
Signed-off-by: Haiwei Li <haiwei.li@intel.com>