cf22a57c1a
IEvent was a synchronization primitive which caused some confusion in the interface. Originally the event object was paired with an asynchronous task, and the asynchronous task would signal this event when the corresponding output was ready to be used. In the case of IDevice::prepareModel, the function call would return an IPreparedModel object that was not guaranteed to be prepared until the runtime had returned from waiting on the corresponding event object. The event object has been changed to two explicit callbacks-- IPreparedModelCallback and IExecutionCallback. Now, IDevice::prepareModel no longer returns an unfinished IPreparedModel; instead, it will pass the IPreparedModel object to the runtime through IPreparedModelCallback::notify. When the runtime retreives the IPreparedModel object, the asynchronous task has already finished preparing the model. The two callbacks are used for different purposes. Each has its own version of notify to pass the data back to the runtime: * IPreparedModelCallback::notify(ErrorStatus, IPreparedModel) * IExecutionCallback::notify(ErrorStatus) Bug: 63905942 Test: mm, vts, ml/nn/runtime/tests Change-Id: I0c88cd262ba762e0af15e9da31ebe813a5d150b2
44 lines
1.9 KiB
Text
44 lines
1.9 KiB
Text
/*
|
|
* Copyright (C) 2017 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package android.hardware.neuralnetworks@1.0;
|
|
|
|
/**
|
|
* IExecutionCallback must be used to return the error status result from an
|
|
* execution asynchronously launched from IPreparedModel::execute.
|
|
*/
|
|
interface IExecutionCallback {
|
|
|
|
/**
|
|
* notify must be invoked immediately after the asynchronous task has
|
|
* finished performing the execution. notify must be provided with the
|
|
* ErrorStatus resulting from the execution. If the asynchronous task
|
|
* is not launched, notify must be invoked with the appropriate error.
|
|
*
|
|
* @return param Error status returned from launching the asynchronous task
|
|
* (if the launch fails) or from the asynchronous task itself
|
|
* (if the launch succeeds). Must be:
|
|
* - NONE if the asynchronous execution was successful
|
|
* - DEVICE_UNAVAILABLE if driver is offline or busy
|
|
* - GENERAL_FAILURE if the asynchronous task resulted in an
|
|
* unspecified error
|
|
* - OUTPUT_INSUFFICIENT_SIZE if provided output buffer is
|
|
* not large enough to store the resultant values
|
|
* - INVALID_ARGUMENT if one of the input arguments to
|
|
* prepareModel is invalid
|
|
*/
|
|
oneway notify(ErrorStatus status);
|
|
};
|