Clarify deprecation message

Note that it's still used if mapper@4 is still used

Test: n/a doc only change
Change-Id: I21d3070684592f2931842acb43466ae4236856e6
This commit is contained in:
John Reck 2023-01-09 16:02:54 -05:00
parent a74147236c
commit a190be3f86
3 changed files with 8 additions and 6 deletions

View file

@ -34,7 +34,7 @@
package android.hardware.graphics.allocator;
@Backing(type="int") @VintfStability
enum AllocationError {
BAD_DESCRIPTOR = 0,
NO_RESOURCES = 1,
UNSUPPORTED = 2,
BAD_DESCRIPTOR,
NO_RESOURCES,
UNSUPPORTED,
}

View file

@ -35,7 +35,7 @@ package android.hardware.graphics.allocator;
@VintfStability
interface IAllocator {
/**
* @deprecated As of android.hardware.graphics.allocator-V2, this is deprecated & replaced with allocate2
* @deprecated As of android.hardware.graphics.allocator-V2 in combination with AIMAPPER_VERSION_5 this is deprecated & replaced with allocate2. If android.hardware.graphics.mapper@4 is still in use, however, this is still required to be implemented.
*/
android.hardware.graphics.allocator.AllocationResult allocate(in byte[] descriptor, in int count);
android.hardware.graphics.allocator.AllocationResult allocate2(in android.hardware.graphics.allocator.BufferDescriptorInfo descriptor, in int count);

View file

@ -32,8 +32,10 @@ interface IAllocator {
* @param count The number of buffers to allocate.
* @return An AllocationResult containing the result of the allocation
* @throws AllocationError on failure
* @deprecated As of android.hardware.graphics.allocator-V2, this is deprecated & replaced with
* allocate2
* @deprecated As of android.hardware.graphics.allocator-V2 in combination with
* AIMAPPER_VERSION_5 this is deprecated & replaced with allocate2.
* If android.hardware.graphics.mapper@4 is still in use, however, this is
* still required to be implemented.
*/
AllocationResult allocate(in byte[] descriptor, in int count);