Merge "[VNDK] Update document for return value of various APIs." into pi-dev am: 05b6f27d87 (595c17d8) · Commits · e / os / android_frameworks_native

libs/nativewindow/include/android/hardware_buffer.h

+5 −5

Original line number	Original line	Diff line number	Diff line
	@@ -219,7 +219,7 @@ typedef struct AHardwareBuffer AHardwareBuffer;
	* Allocates a buffer that backs an AHardwareBuffer using the passed		* Allocates a buffer that backs an AHardwareBuffer using the passed
	* AHardwareBuffer_Desc.		* AHardwareBuffer_Desc.
	*		*
	* \return NO_ERROR on success, or an error number of the allocation fails for		* \return 0 on success, or an error number of the allocation fails for
	* any reason. The returned buffer has a reference count of 1.		* any reason. The returned buffer has a reference count of 1.
	*/		*/
	int AHardwareBuffer_allocate(const AHardwareBuffer_Desc* desc,		int AHardwareBuffer_allocate(const AHardwareBuffer_Desc* desc,
	@@ -272,7 +272,7 @@ void AHardwareBuffer_describe(const AHardwareBuffer* buffer,
	* may return an error or leave the buffer's content into an indeterminate		* may return an error or leave the buffer's content into an indeterminate
	* state.		* state.
	*		*
	* \return NO_ERROR on success, BAD_VALUE if \a buffer is NULL or if the usage		* \return 0 on success, -EINVAL if \a buffer is NULL or if the usage
	* flags are not a combination of AHARDWAREBUFFER_USAGE_CPU_*, or an error		* flags are not a combination of AHARDWAREBUFFER_USAGE_CPU_*, or an error
	* number of the lock fails for any reason.		* number of the lock fails for any reason.
	*/		*/
	@@ -286,7 +286,7 @@ int AHardwareBuffer_lock(AHardwareBuffer* buffer, uint64_t usage,
	* completed. The caller is responsible for closing the fence when it is no		* completed. The caller is responsible for closing the fence when it is no
	* longer needed.		* longer needed.
	*		*
	* \return NO_ERROR on success, BAD_VALUE if \a buffer is NULL, or an error		* \return 0 on success, -EINVAL if \a buffer is NULL, or an error
	* number if the unlock fails for any reason.		* number if the unlock fails for any reason.
	*/		*/
	int AHardwareBuffer_unlock(AHardwareBuffer* buffer, int32_t* fence);		int AHardwareBuffer_unlock(AHardwareBuffer* buffer, int32_t* fence);
	@@ -294,7 +294,7 @@ int AHardwareBuffer_unlock(AHardwareBuffer* buffer, int32_t* fence);
	/**		/**
	* Send the AHardwareBuffer to an AF_UNIX socket.		* Send the AHardwareBuffer to an AF_UNIX socket.
	*		*
	* \return NO_ERROR on success, BAD_VALUE if \a buffer is NULL, or an error		* \return 0 on success, -EINVAL if \a buffer is NULL, or an error
	* number if the operation fails for any reason.		* number if the operation fails for any reason.
	*/		*/
	int AHardwareBuffer_sendHandleToUnixSocket(const AHardwareBuffer* buffer, int socketFd);		int AHardwareBuffer_sendHandleToUnixSocket(const AHardwareBuffer* buffer, int socketFd);
	@@ -302,7 +302,7 @@ int AHardwareBuffer_sendHandleToUnixSocket(const AHardwareBuffer* buffer, int so
	/**		/**
	* Receive the AHardwareBuffer from an AF_UNIX socket.		* Receive the AHardwareBuffer from an AF_UNIX socket.
	*		*
	* \return NO_ERROR on success, BAD_VALUE if \a outBuffer is NULL, or an error		* \return 0 on success, -EINVAL if \a outBuffer is NULL, or an error
	* number if the operation fails for any reason.		* number if the operation fails for any reason.
	*/		*/
	int AHardwareBuffer_recvHandleFromUnixSocket(int socketFd, AHardwareBuffer** outBuffer);		int AHardwareBuffer_recvHandleFromUnixSocket(int socketFd, AHardwareBuffer** outBuffer);