drivers: sensor: Document blocking behavior of sample fetch functions

Updates the sensor driver API documentation to explicitly state that
sample fetch functions block until the fetch operation is complete.

Fixes #53728

Signed-off-by: Maureen Helm <maureen.helm@intel.com>