tests: drivers: gpio: basic_api: Improve test

Add return code checking for gpio_pin_interrupt_configure functions.
Add disabling pin interrupt at the end of the test to restore pin
state.

Signed-off-by: Krzysztof Chruściński <krzysztof.chruscinski@nordicsemi.no>