Merge "add filter delay hint"

/*

 * Copyright 2021 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.

 */

///////////////////////////////////////////////////////////////////////////////

// THIS FILE IS IMMUTABLE. DO NOT EDIT IN ANY CASE.                          //

///////////////////////////////////////////////////////////////////////////////

// This file is a snapshot of an AIDL file. Do not edit it manually. There are

// two cases:

// 1). this is a frozen version file - do not edit this in any case.

// 2). this is a 'current' file. If you make a backwards compatible change to

//     the interface (from the latest frozen version), the build system will

//     prompt you to update this file with `m <name>-update-api`.

//

// You must not make a backward incompatible change to any AIDL file built

// with the aidl_interface module type with versions property set. The module

// type is used to build AIDL files in a way that they can be used across

// independently updatable components of the system. If a device is shipped

// with such a backward incompatible change, it has a high risk of breaking

// later when a module using the interface is updated, e.g., Mainline modules.

package android.hardware.tv.tuner;

/* @hide */

@VintfStability

parcelable FilterDelayHint {

  android.hardware.tv.tuner.FilterDelayHintType hintType = android.hardware.tv.tuner.FilterDelayHintType.INVALID;

  int hintValue;

}

/*

 * Copyright 2021 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.

 */

///////////////////////////////////////////////////////////////////////////////

// THIS FILE IS IMMUTABLE. DO NOT EDIT IN ANY CASE.                          //

///////////////////////////////////////////////////////////////////////////////

// This file is a snapshot of an AIDL file. Do not edit it manually. There are

// two cases:

// 1). this is a frozen version file - do not edit this in any case.

// 2). this is a 'current' file. If you make a backwards compatible change to

//     the interface (from the latest frozen version), the build system will

//     prompt you to update this file with `m <name>-update-api`.

//

// You must not make a backward incompatible change to any AIDL file built

// with the aidl_interface module type with versions property set. The module

// type is used to build AIDL files in a way that they can be used across

// independently updatable components of the system. If a device is shipped

// with such a backward incompatible change, it has a high risk of breaking

// later when a module using the interface is updated, e.g., Mainline modules.

package android.hardware.tv.tuner;

/* @hide */

@Backing(type="int") @VintfStability

enum FilterDelayHintType {

  INVALID = 0,

  TIME_DELAY_IN_MS = 1,

  DATA_SIZE_DELAY_IN_BYTES = 2,

}

  long getId64Bit();

  void releaseAvHandle(in android.hardware.common.NativeHandle avMemory, in long avDataId);

  void setDataSource(in android.hardware.tv.tuner.IFilter filter);

  void setDelayHint(in android.hardware.tv.tuner.FilterDelayHint hint);

}

/*

 * Copyright 2021 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.tv.tuner;

import android.hardware.tv.tuner.FilterDelayHintType;

/**

 * Filter Delay Hint

 * Gives information to the filter to assist in delaying / accumulating filter events.

 * See FilterDelayHintType for more information regarding the hintValue units.

 * @hide

 */

@VintfStability

parcelable FilterDelayHint {

    FilterDelayHintType hintType = FilterDelayHintType.INVALID;

    int hintValue;

}

/*

 * Copyright 2021 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.tv.tuner;

/**

 * Filter Delay Hint Type

 * Specifies the type of filter delay.

 * @hide

 */

@VintfStability

@Backing(type="int")

enum FilterDelayHintType {

    /**

     * Invalid type to be used as default value.

     */

    INVALID,

    /**

     * Hint that can be used by the filter implementation to make decisions about

     * delaying the filter callback until a specified amount of time has passed.

     * For time delays, the hint value contains time in milliseconds.

     */

    TIME_DELAY_IN_MS,

    /**

     * Hint that can be used by the filter implementation to make decisions about

     * delaying the filter callback until a specified amount of data has been

     * accumulated.

     * For data size delays, the hint value contains the data size in bytes.

     */

    DATA_SIZE_DELAY_IN_BYTES,

}