[flang] Add lowering C interoperability test

This patch adds a lowering test for the C
interoperability.

This patch is part of the upstreaming effort from fir-dev branch.

Reviewed By: PeteSteinfeld

Differential Revision: https://reviews.llvm.org/D122307



Co-authored-by: Eric Schweitz <eschweitz@nvidia.com>