Merge "HWC2: Clarify null client target handle" into nyc-dev am: 0154a6b08d
am: 1d61e380eb

* commit '1d61e380eb32f6dd7e846508032e9e501e10cd24':
  HWC2: Clarify null client target handle

Change-Id: I0a65bc0604ade6550190f4cdc6e523f02b25b1a1
diff --git a/include/hardware/hwcomposer2.h b/include/hardware/hwcomposer2.h
index 095557a..f42456b 100644
--- a/include/hardware/hwcomposer2.h
+++ b/include/hardware/hwcomposer2.h
@@ -1384,6 +1384,10 @@
  * prior to the call to presentDisplay, and layers not marked as
  * HWC2_COMPOSITION_CLIENT should be composited with this buffer by the device.
  *
+ * The buffer handle provided may be null if no layers are being composited by
+ * the client. This must not result in an error (unless an invalid display
+ * handle is also provided).
+ *
  * Also provides a file descriptor referring to an acquire sync fence object,
  * which will be signaled when it is safe to read from the client target buffer.
  * If it is already safe to read from this buffer, -1 may be passed instead.