drivers/clock_control: stm32: rename macros to avoid z_ namespace

A few macros used the reserved z_ prefix, this commit refactors
the driver to avoid them.

Signed-off-by: Thomas Stranger <thomas.stranger@outlook.com>