include: drivers: video: doxygen fixes for video-controls.h

A bit of doxygen love to this header to improve documentation coverage,
mainly focusing on missing documentation for a few enumerations, as well
as making sure javadoc-style comments are used where appropriate.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>