drivers: video: doc: Cleanup Doxygen documentation

Fixed several missing documentation comments, cleanup struct documentation,
and group pixel formats.

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