libbladeRF: Header file cleanup

Changed '@return' text items to reference Error code list.
Stubbed out some undocumented items with 'TODO' to quiet Doxygen warnings.
Moved extern "C" to include bladerf structure.