summaryrefslogtreecommitdiffstats
path: root/systemhelper/1.0/ISystemResource.hal
diff options
context:
space:
mode:
Diffstat (limited to 'systemhelper/1.0/ISystemResource.hal')
-rw-r--r--systemhelper/1.0/ISystemResource.hal73
1 files changed, 73 insertions, 0 deletions
diff --git a/systemhelper/1.0/ISystemResource.hal b/systemhelper/1.0/ISystemResource.hal
new file mode 100644
index 0000000..0b5adc0
--- /dev/null
+++ b/systemhelper/1.0/ISystemResource.hal
@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2019, The Linux Foundation. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following
+ * disclaimer in the documentation and/or other materials provided
+ * with the distribution.
+ * * Neither the name of The Linux Foundation nor the names of its
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
+ * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+ * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+ * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ */
+
+package vendor.qti.hardware.systemhelper@1.0;
+
+import android.hardware.graphics.bufferqueue@1.0::IGraphicBufferProducer;
+
+interface ISystemResource {
+ /**
+ * Acquire a system resource
+ *
+ * @param resource resource to acquire
+ * @return status resource acquisition status
+ * 0 in case of success and negative in case of failure
+ * @return resourceId unique resource identifier for acquired resource
+ * Note : resourceId stands invalid in case of API returned error
+ */
+ acquire(SystemResourceType resource) generates (int32_t status,
+ uint32_t resourceId);
+ /**
+ * Acquire a system graphics surface.
+ *
+ * @param width surface width
+ * @param height surface height
+ * @return status resource acquisition status
+ * 0 in case of success and negative in case of failure
+ * @return resourceId unique resource identifier for acquired resource
+ * Note : resourceId stands invalid in case of API returned error
+ * @return surface IGraphicBufferProducer interface for buffer enqueue/dequeue
+ */
+ acquireSurface(uint32_t width, uint32_t height)
+ generates (int32_t status,
+ uint32_t resourceId,
+ IGraphicBufferProducer surface);
+
+ /**
+ * Release an acquired resource
+ *
+ * Both resource and surface shall be released via this API.
+ *
+ * @param resourceId unique resource identifier to be released
+ * @return status resource release status
+ * 0 in case of success and -1 in case of failure
+ */
+ release(uint32_t resourceId) generates (int32_t status);
+};