Update header file documentation

Update documentation in driver header file.

Some functions were inconsistently returning boolean status. These
functions have been updated to return integer status, with 0 on
success and negative error code on failure.

Change-Id: Ie044bf5b4f2daaff348e698fa6147472dbc582a9