Merge "Add @deprecated and @return error annotations" into main am: b3229b6f86

Original change: https://android-review.googlesource.com/c/platform/hardware/interfaces/+/3420539

Change-Id: I6081a64923526a9d454ff15d1a53e3817454a28f
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>