/*
 * Copyright (c) Hisilicon Technologies Co., Ltd. 2019-2019. All rights reserved.
 * Description: Define functions used to test function of demux driver
 * Author: Hisilicon
 * Create: 2019-4-25
 */

#ifndef __UAPI_DEMUX_H__
#define __UAPI_DEMUX_H__

#include "td_type.h"
#include "uapi_video.h"
#include "uapi_stream.h"

#ifdef __cplusplus
#if __cplusplus
extern "C" {
#endif
#endif

/* Maximum depth of a filter. */
#define DMX_FILTER_MAX_DEPTH 16
#define DMX_MAX_IDX_ACQUIRED_EACH_TIME 256
#define DMX_MAX_REC_DATA_PARTS   2

/* Defines the capability of the DEMUX module.CNcomment:定义DEMUX模块业务功能结构体 */
typedef struct {
    td_u32 dmx_num;             /* Number of DEMUX devices.CNcomment:设备数量 */
    td_u32 if_port_num;         /* Number of IF ports.
                                 * CNcomment: IF 端口数量(与TS In 端口都是通过Tuner 连接,
                                 * 但是IF 端口是使用内置 QAM)
                                 */
    td_u32 tsi_port_num;        /* Number of TS In ports.
                                 * CNcomment: TS In 端口数量 (与IF端口都是通过Tuner 连接,
                                 * 但是IF 端口是使用内置 QAM)
                                 */
    td_u32 tso_port_num;        /* Number of TS Out ports.CNcomment: TS Out 端口数量 */
    td_u32 ram_port_num;        /* Number of Ram ports.CNcomment: Ram端口数量 */
    td_u32 tag_port_num;        /* Number of Tag ports.CNcomment: Tag端口数量 */
    td_u32 tsio_port_num;       /* Number of Tsio ports.CNcomment: Tsio端口数量 */
    td_u32 total_play_chan_num; /* Number of channels, containing the audio and video channels.
                                 * CNcomment:总通道数量，含音视频通道的数量
                                 */
    td_u32 av_play_chan_num;    /* Number of av channels.CNcomment:音视频通道数量 */
    td_u32 rec_chan_num;        /* Number of record channelsCNcomment:录制通道的数量 */
    td_u32 filter_num;          /* Number of filters.CNcomment:过滤器数量 */
    td_u32 desc_num;            /* Number of descramblers.CNcomment: 解扰器数量 */
} uapi_dmx_capability;

/* TSO port ID.CNcomment:TS输出端口ID */
typedef enum {
    UAPI_DMX_PORT_TSO_0, /* The first TS OUT port .CNcomment:TS Out 端口0 */
    UAPI_DMX_PORT_TSO_1,
    UAPI_DMX_PORT_TSO_2,
    UAPI_DMX_PORT_TSO_3
} uapi_dmx_tso_port;

/* TS port ID.CNcomment:TS端口ID */
typedef enum {
    UAPI_DMX_PORT_IF_0 = 0x0, /* The first IF port (port with  QAM  inside chipset).
                                 * CNcomment: IF 端口0, (IF 端口是内置QAM端口，通常不多于一个)
                                 */
    UAPI_DMX_PORT_IF_1,
    UAPI_DMX_PORT_IF_2,
    UAPI_DMX_PORT_IF_3,
    UAPI_DMX_PORT_IF_4,
    UAPI_DMX_PORT_IF_5,
    UAPI_DMX_PORT_IF_6,
    UAPI_DMX_PORT_IF_7,
    UAPI_DMX_PORT_IF_8,
    UAPI_DMX_PORT_IF_9,
    UAPI_DMX_PORT_IF_10,
    UAPI_DMX_PORT_IF_11,
    UAPI_DMX_PORT_IF_12,
    UAPI_DMX_PORT_IF_13,
    UAPI_DMX_PORT_IF_14,
    UAPI_DMX_PORT_IF_15,
    UAPI_DMX_PORT_TSI_0 = 0x20, /* The first TS IN  port .CNcomment:TSIN 端口0, (TSIN 端口即Tuner 端口) */
    UAPI_DMX_PORT_TSI_1,
    UAPI_DMX_PORT_TSI_2,
    UAPI_DMX_PORT_TSI_3,
    UAPI_DMX_PORT_TSI_4,
    UAPI_DMX_PORT_TSI_5,
    UAPI_DMX_PORT_TSI_6,
    UAPI_DMX_PORT_TSI_7,
    UAPI_DMX_PORT_TSI_8,
    UAPI_DMX_PORT_TSI_9,
    UAPI_DMX_PORT_TSI_10,
    UAPI_DMX_PORT_TSI_11,
    UAPI_DMX_PORT_TSI_12,
    UAPI_DMX_PORT_TSI_13,
    UAPI_DMX_PORT_TSI_14,
    UAPI_DMX_PORT_TSI_15,
    UAPI_DMX_PORT_RAM_0 = 0x80, /* The first RAM port .CNcomment:RAM 端口0 */
    UAPI_DMX_PORT_RAM_1,
    UAPI_DMX_PORT_RAM_2,
    UAPI_DMX_PORT_RAM_3,
    UAPI_DMX_PORT_RAM_4,
    UAPI_DMX_PORT_RAM_5,
    UAPI_DMX_PORT_RAM_6,
    UAPI_DMX_PORT_RAM_7,
    UAPI_DMX_PORT_RAM_8,
    UAPI_DMX_PORT_RAM_9,
    UAPI_DMX_PORT_RAM_10,
    UAPI_DMX_PORT_RAM_11,
    UAPI_DMX_PORT_RAM_12,
    UAPI_DMX_PORT_RAM_13,
    UAPI_DMX_PORT_RAM_14,
    UAPI_DMX_PORT_RAM_15,
    UAPI_DMX_PORT_TSIO_0 = 0xA0, /* The first TSIO port .CNcomment:TSIO 端口0 */
    UAPI_DMX_PORT_TSIO_1,
    UAPI_DMX_PORT_TSIO_2,
    UAPI_DMX_PORT_TSIO_3,
    UAPI_DMX_PORT_TSIO_4,
    UAPI_DMX_PORT_TSIO_5,
    UAPI_DMX_PORT_TSIO_6,
    UAPI_DMX_PORT_TSIO_7,
    UAPI_DMX_PORT_TAG_0 = 0xB0, /* The first Tag port .CNcomment:Tag 端口0 */
    UAPI_DMX_PORT_TAG_1,
    UAPI_DMX_PORT_TAG_2,
    UAPI_DMX_PORT_TAG_3,
    UAPI_DMX_PORT_TAG_4,
    UAPI_DMX_PORT_TAG_5,
    UAPI_DMX_PORT_TAG_6,
    UAPI_DMX_PORT_TAG_7,
    UAPI_DMX_PORT_MAX
} uapi_dmx_port;

/* TS port mode.CNcomment:TS端口模式 */
typedef enum {
    UAPI_DMX_PORT_MODE_EXTERNAL, /* External TS input mode.CNcomment:外部TS输入 */
    UAPI_DMX_PORT_MODE_INTERNAL, /* Internal TS input mode.CNcomment:内部TS输入 */
    UAPI_DMX_PORT_MODE_RAM,      /* Memory input mode.CNcomment:从内存输入 */

    UAPI_DMX_PORT_MODE_MAX
} uapi_dmx_port_mode;

/* TS port type.CNcomment:TS端口类型 */
typedef enum {
    UAPI_DMX_PORT_TYPE_PARALLEL_BURST,            /* Parallel burst mode.CNcomment:并行BURST模式 */
    UAPI_DMX_PORT_TYPE_PARALLEL_VALID,            /* Parallel valid mode.CNcomment:并行VALID模式 */
    UAPI_DMX_PORT_TYPE_PARALLEL_NOSYNC_188,       /* Self-sync 188 mode.CNcomment:自同步188模式 */
    UAPI_DMX_PORT_TYPE_PARALLEL_NOSYNC_204,       /* Self-sync 204 mode.CNcomment:自同步204模式 */
    UAPI_DMX_PORT_TYPE_PARALLEL_NOSYNC_188_204,   /* self-sync 188/204 auto-identification mode.
                                                     * CNcomment:自同步188/204自动识别模式
                                                     */
    UAPI_DMX_PORT_TYPE_SERIAL,                    /* Serial sync mode, 1bit.CNcomment:串行sync模式, 1bit串行 */
    UAPI_DMX_PORT_TYPE_SERIAL_NOSYNC,             /* Serial nosync mode, 1bitCNcomment:串行nosync模式, 1bit串行 */
    UAPI_DMX_PORT_TYPE_SERIAL_NOSYNC_NOVALID,     /* Serial nosync novalid mode, 1bit.
                                                     * CNcomment:串行nosync novalid模式, 1bit串行
                                                     */
    UAPI_DMX_PORT_TYPE_SERIAL2BIT,                /* Serial sync mode, 2bit.CNcomment:串行sync模式, 2bit串行 */
    UAPI_DMX_PORT_TYPE_SERIAL2BIT_NOSYNC,         /* Serial nosync mode, 2bitCNcomment:串行nosync模式, 2bit串行 */
    UAPI_DMX_PORT_TYPE_SERIAL2BIT_NOSYNC_NOVALID, /* Serial nosync novalid mode, 2bit.
                                                     * CNcomment:串行nosync novalid模式, 2bit串行
                                                     */
    UAPI_DMX_PORT_TYPE_USER_DEFINED,              /* User defined mode.CNcomment:用户自定义模式 */
    UAPI_DMX_PORT_TYPE_AUTO,                      /* Auto mode.CNcomment: 自动模式 */
    UAPI_DMX_PORT_TYPE_MAX
} uapi_dmx_port_type;

/* TSO clock mode.CNcomment:TS输出端口时钟模式 */
typedef enum {
    UAPI_DMX_TSO_CLK_MODE_NORMAL, /* Normal clock: clock always active.CNcomment:普通模式的时钟,时钟平率均匀 */
    UAPI_DMX_TSO_CLK_MODE_JITTER, /* Jittered clock: clock active only when outputing data.
                                     * CNcomment:Jittered 模式时钟,时钟频率不均匀,此时只有在有数据输出时才会出时钟
                                     * (valid信号为高的情况下)
                                     */
    UAPI_DMX_TSO_CLK_MODE_MAX
} uapi_dmx_tso_clk_mode;

/* TSO valid mode.CNcomment:TS输出端口valid信号模式 */
typedef enum {
    UAPI_DMX_TSO_VALID_ACTIVE_OUTPUT, /* Valid signal high when outputing datas.CNcomment:valid信号在输出数据时为高 */
    UAPI_DMX_TSO_VALID_ACTIVE_HIGH,   /* Valid signal always high.CNcomment:valid信号总是为高 */
    UAPI_DMX_TSO_VALID_ACTIVE_MAX
} uapi_dmx_tso_valid_mode;

/* TSO port signal line selector.CNcomment:TS输出端口线序选择 */
typedef enum {
    UAPI_DMX_TSO_SERIAL_BIT_0 = 0x0, /* Serial output data using data[0] as signal line.
                                        * CNcomment:使用data[0]作为串行信号线输出
                                        */
    UAPI_DMX_TSO_SERIAL_BIT_7 = 0x7, /* Serial output data using data[7] as signal line.
                                        * CNcomment:使用data[7]作为串行信号线输出
                                        */
    UAPI_DMX_TSO_SERIAL_BIT_MAX
} uapi_dmx_tso_serial_bit;

/* TS out mode clock frequency.CNcomment:TS输出模块时钟频率,注意,实际的TS out 端口输出频率 = TSO 模块时钟/分频因子 */
typedef enum {
    UAPI_DMX_TSO_CLK_100M,  /* TS out mode clock frequency 100M.CNcomment:TS输出模块时钟频率选择为100M */
    UAPI_DMX_TSO_CLK_150M,  /* TS out mode clock frequency 150M.CNcomment:TS输出模块时钟频率选择为150M */
    UAPI_DMX_TSO_CLK_1200M, /* TS out mode clock frequency 1200M.CNcomment:TS输出模块时钟频率选择为1200M */
    UAPI_DMX_TSO_CLK_1500M, /* TS out mode clock frequency 1500M.CNcomment:TS输出模块时钟频率选择为1500M */
    UAPI_DMX_TSO_CLK_MAX
} uapi_dmx_tso_clk;

/* Tag sync mode.CNcomment: Tag 同步模式 */
typedef enum {
    UAPI_DMX_SYNC_ON_TAG = 0x0,     /* < tag sync signal at tag head.CNcomment:sync信号在tag头 */
    UAPI_DMX_SYNC_ON_TS_HEAD = 0x1, /* < tag sync signal at 47 heade.<CNcomment:sync信号在47头 */
    UAPI_DMX_SYNC_MAX
} uapi_dmx_tag_sync_mode;

/* TS Tag attributes.CNcomment: TS Tag 配置属性 */
#define MAX_TAG_LENGTH 12
typedef struct {
    uapi_dmx_port ts_source; /* [IN]Source of this Tag port, can choose from UAPI_DMX_PORT_TSI_XX.
                                * CNcomment:Tag 端口数据源,可以从UAPI_DMX_PORT_TSI_XX中选择
                                */
    td_bool enable;            /* [IN & OUT]Port state(default disabled), which is an input para when setTagAttr,
                                * otherwise out para when getTagAttr.
                                * CNcomment:端口使能(默认不使能),setTagAttr时作为输入参数,getTagAttr时作为输出参数
                                */
    uapi_dmx_tag_sync_mode sync_mode; /* [IN & OUT]Sync mode(default UAPI_DMX_TAG_HEAD_SYNC),
                                         * which is an input para when setTagAttr, otherwise out para when getTagAttr
                                         * CNcomment:同步模式(默认值为UAPI_DMX_TAG_HEAD_SYNC ),
                                         * setTagAttr时作为输入参数,getTagAttr时作为输出参数
                                         */
    td_u32 tag_len;                     /* [IN & OUT]Valid tag length(1 ~ 12bytes), which is an input para when
                                         * setTagAttr, otherwise out para when getTagAttr.
                                         * CNcomment:有效tag长度(1~12字节),setTagAttr时作为输入参数,
                                         * getTagAttr时作为输出参数
                                         */
    td_u8 tag[MAX_TAG_LENGTH];          /* [IN]tag index value.CNcomment:端口的tag值 */
} uapi_dmx_tag_attr;

/* TS out port attributes.CNcomment:TS Out 端口属性 */
typedef struct {
    td_bool enable;                         /* Port enable, default value TD_TRUE means enable.
                                             * CNcomment:端口使能,默认使能
                                             */
    uapi_dmx_port ts_source;              /* Source of this TS Out port, can choose from UAPI_DMX_PORT_IF_0 to
                                             * UAPI_DMX_PORT_TSI_9.
                                             * CNcomment:TS Out 端口数据源,可以从UAPI_DMX_PORT_IF_0 到
                                             * UAPI_DMX_PORT_TSI_9 之间选择
                                             */
    td_bool clk_reverse;                    /* Clock phase reverse, default value TD_FALSE means do not
                                             * reverse the phase of clock.
                                             * CNcomment:端口时钟反向,默认不反向
                                             */
    uapi_dmx_tso_clk_mode clk_mode;       /* Clock mode: UAPI_DMX_TSO_CLK_MODE_NORMAL is the default value.
                                             * CNcomment:时钟模式: 默认值为 UAPI_DMX_TSO_CLK_MODE_NORMAL
                                             */
    uapi_dmx_tso_valid_mode valid_mode;   /* Wether valid signal always enable : UAPI_DMX_TSO_VALID_ACTIVE_OUTPUT
                                             * is the default value.
                                             * CNcomment:Valid 模式: 默认值为:UAPI_DMX_TSO_VALID_ACTIVE_OUTPUT
                                             */
    td_bool bit_sync;                       /* The sync signal duration : TD_TRUE: only valid when output the first
                                             * bit(default). TD_FALSE: keep when outputing the whole byte
                                             * CNcomment:sync 信号有效期 : TD_TRUE: 只在输出第一个bit时有效 (默认).
                                             * TD_FALSE: 在输出整个字节时都有效
                                             */
    uapi_dmx_port_type port_type;         /* Port out put mode: serial(UAPI_DMX_PORT_TYPE_SERIAL),
                                             * parallel(UAPI_DMX_PORT_TYPE_PARALLEL_BURST) or serial 2bits
                                             * (UAPI_DMX_PORT_TYPE_SERIAL2BIT) mode.
                                             * default is serial(UAPI_DMX_PORT_TYPE_SERIAL)
                                             */
                                            /* CNcomment:TSO模块输出模式:串行(UAPI_DMX_PORT_TYPE_SERIAL)，
                                             * 并行(UAPI_DMX_PORT_TYPE_PARALLEL_BURST)或者
                                             * 串行2bit(UAPI_DMX_PORT_TYPE_SERIAL2BIT)模式。
                                             * 默认是串行(UAPI_DMX_PORT_TYPE_SERIAL)
                                             */
    uapi_dmx_tso_serial_bit bit_selector; /* Port line sequence select In serial mode.only valid when using serial out
                                             * put mode,UAPI_DMX_TSO_SERIAL_BIT_7 is the default value.
                                             * CNcomment:端口串行模式线序选择,只有使用串行输出模式的时候有效,
                                             * 默认值为 UAPI_DMX_TSO_SERIAL_BIT_7
                                             */
    td_bool lsb;                            /* Out put byte endian .only valid when using serial out put mode:
                                             * TD_FALSE: first output MSB (default). TD_TRUE:  first output LSB
                                             * CNcomment:端口输出大小端模式,只有使用串行输出模式的时候有效:
                                             * TD_FALSE: 首先输出最高位 (默认) . TD_TRUE: 首先输出最低位
                                             */
    uapi_dmx_tso_clk clk;                 /* TS out mode clock frequency, default is UAPI_DMX_TSO_CLK_150M.
                                             * CNcomment:TS输出模块时钟频率,默认是 UAPI_DMX_TSO_CLK_150M
                                             */
    td_u32 clk_div;                         /* TS out mode clock frequency divider, must be times of 2,
                                             * and must meet (2 <= u32ClkDiv <= 32) .default is 2.
                                             * CNcomment:TSO模块分频因子,必须是2的整数倍,取值范围在2与32之间
                                             */
} uapi_dmx_tso_port_attr;

/* TS port attributes.CNcomment:TS端口属性 */
typedef struct {
    uapi_dmx_port_type port_type;        /* Port type.CNcomment:端口类型 */
    td_u32 sync_lost_threshold;            /* Sync loss threshold.The default value is recommended.
                                            * CNcomment:同步丢失门限，推荐使用默认值
                                            */
    td_u32 sync_lock_threshold;            /* Sync lock threshold.The default value is recommended.
                                            * CNcomment:同步锁定门限，推荐使用默认值
                                            */
    td_u32 serial_bit_selector;            /* Port line sequence select.
                                            * In parallel mode: 0:cdata[7] is the most significant bit(MSB) (default)
                                            * 1: cdata[0] is the MSB.
                                            * In serial mode: 1:cdata[0] is the data line (default).
                                            * 0:cdata[7] is the data line.
                                            * CNcomment:端口线序选择。并行时:0: 表示cdata[7]最高位(默认);
                                            * 1: 表示cdata[0]最高位。
                                            * 串行时:1: 表示cdata[0]为数据线(默认); 0: 表示cdata[7]为数据线
                                            */
    uapi_dmx_port serial_port_share_clk; /* Port of clock that this port shared, only valid for TSI port tpye.
                                            * CNcomment:指定该端口所复用时钟的对应端口，该成员仅对TSI端口类型有效
                                            */
    td_bool frontend_clk_mode;             /* Frontend Clock Mode, the configure must be sync with Tuner,
                                            * 0: single edge-triggered, 1: double edge-triggered.
                                            * CNcomment:Frontend输入时钟边沿选择，必须和frontend配置一致，默认为0，
                                            * 单沿触发.0: 单沿触发; 1: 双沿触发
                                            */
    td_bool frontend_clk_inverse;          /* Whether to reverse the phase of the clock input from the frontend.
                                            * CNcomment:Frontend输入时钟是否反相.0: 同相(默认); 1: 反相
                                            */
    td_bool frontend_err_mode;             /* Level mode of the cerr_n line from the tuner to a DEMUX.
                                            * 0: A data error occurs when the cerr_n line is high.
                                            * 1: A data error occurs when the cerr_n line is low (default).
                                            * CNcomment:tuner到DEMUX的cerr_n线电平模式:
                                            * 0: 表示cerr_n线为高时表示数据错误;
                                            * 1: 表示cerr_n线为低时表示数据错误 (默认)
                                            */
    td_u32 user_def_len1;                  /* User defined length1, valid when enPortType is
                                            * UAPI_DMX_PORT_TYPE_USER_DEFINED,188~255.
                                            * CNcomment:用户自定义长度检测包长1，只有端口类型为用户自定义时有效，
                                            * 有效范围188~255
                                            */
    td_u32 user_def_len2;                  /* User defined length2, valid when enPortType is
                                            * UAPI_DMX_PORT_TYPE_USER_DEFINED,188~255.
                                            * CNcomment:用户自定义长度检测包长2，只有端口类型为用户自定义时有效，
                                            * 有效范围188~255
                                            */
} uapi_dmx_port_attr;

/* Status of the TS port. CNcomment:TS端口的状态 */
typedef struct {
    td_u32 ts_pack_cnt;     /* Number of TS packets received from the TS port.CNcomment:端口收到的TS包计数 */
    td_u32 err_ts_pack_cnt; /* Number of error TS packets received from the TS port.CNcomment:端口上错误TS包的计数 */
    td_u32 ts_sync_byte_err_cnt; /* Number of sync byte error TS packets received from the TS port.
                                  * CNcomment:端口接收到非法传输同步字节的TS包计数
                                  */
    td_u32 ts_sync_loss_cnt;     /* Number of sync loss TS packets received from the TS port.
                                  * CNcomment:端口接收到同步丢失的TS包计数
                                  */
    td_u32 ts_pack_drained_cnt;  /* Number of Drained TS packets received from the TS port.
                                  * CNcomment:端口成功获取到的合法TS包计数
                                  */
    td_u32 pack_dis_cc_cnt;      /* Number of Discontinuity TS packets received from the TS port.
                                  * CNcomment:解扰后端口收到的不连续错误TS包计数
                                  */
    td_u32 pack_dis_cc_cnt_ca;   /* Number of Discontinuity TS packets received before descrambler from the TS port,
                                  * the value is same as u32PackDisCCCnt.
                                  * CNcomment: 解扰前进入端口的TS包不连续错误次数,值与u32PackDisCCCnt一致
                                  */
} uapi_dmx_port_packet_num;

/* Secure mode type.CNcomment:安全模式类型 */
typedef enum {
    UAPI_DMX_SECURE_MODE_REE = 0, /* <no security protection.CNcomment:无安全保护 */
    UAPI_DMX_SECURE_MODE_TEE,     /* <trustedzone security protection.CNcomment:trustedzone安全保护 */
    UAPI_DMX_SECURE_MODE_MAX
} uapi_dmx_secure_mode;
/* TS buffer attribute. CNcomment:TS buffer 属性 */
typedef struct {
    uapi_dmx_secure_mode secure_mode; /* Secure indication.CNcomment:安全标示 */
    td_u32 buffer_size;                 /* Buffer size.CNcomment:缓冲区大小 */
} uapi_dmx_ts_buffer_attr;

/* Status of a TS buffer of a DEMUX.CNcomment:DEMUX的TS Buffer状态 */
typedef struct {
    td_u32 buffer_size;                 /* Buffer size.CNcomment:缓冲区大小 */
    td_u32 used_size;                   /* Used buffer size.CNcomment:缓冲区已使用大小,该值比实际使用值大0x100字节 */
    uapi_dmx_secure_mode secure_mode; /* Secure indication.CNcomment:安全标示 */
    td_u32 hardware_used_size;          /* Hardware Used Buffer Size, used for special scene.
                                         * CNcomment:硬件当前正在使用的buffer大小，特殊场景使用，
                                         * 外部客户不需要关心
                                         */
} uapi_dmx_ts_buffer_status;

/* Channel type.CNcomment:通道类型 */
typedef enum {
    UAPI_DMX_CHAN_TYPE_SEC = 0, /* Channel that receives sections data such as program specific information (PSI) or
                                   * service information (SI) data.
                                   * CNcomment:用于接收 PSI/SI等secitons数据的通道
                                   */
    UAPI_DMX_CHAN_TYPE_PES,     /* Channel that receives packetized elementary stream (PES) data.
                                   * CNcomment:用于接收PES包数据的通道
                                   */
    UAPI_DMX_CHAN_TYPE_AUD,     /* Channel that receives audio data.
                                   * CNcomment:用于接收音频数据的通道
                                   */
    UAPI_DMX_CHAN_TYPE_VID,     /* Channel that receives video data.
                                   * CNcomment:用于接收视频数据的通道
                                   */
    UAPI_DMX_CHAN_TYPE_POST,    /* Entire-packet posting channel that receives an entire TS packet with a specific
                                   * packet identifier (PID).
                                   * CNcomment:整包上送通道，用于接收某PID的完整TS包
                                   */
    UAPI_DMX_CHAN_TYPE_MAX
} uapi_dmx_chan_type;

/* Cyclic redundancy check (CRC) mode of a channel.CNcomment:通道的CRC模式 */
typedef enum {
    UAPI_DMX_CHAN_CRC_MODE_FORBID = 0,            /* The CRC check is disabled.CNcomment:CRC校验禁止 */
    UAPI_DMX_CHAN_CRC_MODE_FORCE_AND_DISCARD = 1, /* The CRC check is enabled, and the error Section data is discarded
                                                     * CNcomment:CRC校验使能，并丢弃错误Section
                                                     */
    UAPI_DMX_CHAN_CRC_MODE_FORCE_AND_SEND = 2,    /* The CRC check is enabled, and the error Section data is received.
                                                     * CNcomment:CRC校验使能，并上送错误Section
                                                     */
    UAPI_DMX_CHAN_CRC_MODE_MAX
} uapi_dmx_chan_crc_mode;

/* Channel attribute.CNcomment:通道属性 */
typedef struct {
    td_u32 buffer_size;                 /* Buffer size used by channels.CNcomment:通道硬件使用buffer大小 */
    uapi_dmx_chan_type chan_type;     /* Channel type.CNcomment:通道类型 */
    uapi_dmx_chan_crc_mode crc_mode;  /* CRC mode.It is valid for the DEMUX_CHAN_SEC channel.
                                         * CNcomment:CRC模式，通道类型为DMX_CHAN_SEC 时有效
                                         */
    uapi_dmx_secure_mode secure_mode; /* Secure channel indication.CNcomment:安全通道标示 */
} uapi_dmx_chan_attr;

/* Scrambled flag of the channel data.CNcomment:通道数据的加扰标志 */
typedef enum {
    UAPI_DMX_SCRAMBLED_FLAG_TS,  /* TS data is scrambled.CNcomment:数据被TS级加扰 */
    UAPI_DMX_SCRAMBLED_FLAG_PES, /* PES data is scrambled.CNcomment:数据被PES级加扰 */
    UAPI_DMX_SCRAMBLED_FLAG_NO,  /* Data is not scrambled.CNcomment:数据未被加扰 */
    UAPI_DMX_SCRAMBLED_FLAG_MAX
} uapi_dmx_scrambled_flag;

/* Defines the channel status.CNcomment:定义通道状态结构体 */
typedef struct {
    td_bool is_opened;  /* Channel is open or closed.CNcomment:通道打开还是关闭 */
    td_u32 ts_cnt;      /* TS packet CountCNcomment: 视频通道TS包计数 */
    td_u32 cc_disc_cnt; /* CC Discontinuity CountCNcomment:CC不连续计数 */
} uapi_dmx_chan_status;

/* Filter attribute.CNcomment:过滤器属性 */
typedef struct {
    td_u32 filter_depth;                /* Depth of a filter..CNcomment:过滤器深度 */
    td_u8 match[DMX_FILTER_MAX_DEPTH];  /* Matched bytes of a filter.The data is compared by bit.
                                         * CNcomment:过滤器匹配字节,按bit比较
                                         */
    td_u8 mask[DMX_FILTER_MAX_DEPTH];   /* Masked bytes of a filter. The conditions are set by bit.
                                         * 0: no mask. Comparison is required. 1: mask. Comparison is not required.
                                         * CNcomment:过滤器屏蔽字节,按bit设置, 0:没有mask，要进行比较,
                                         * 1:mask起作用，不进行比较 */
    td_u8 negate[DMX_FILTER_MAX_DEPTH]; /* Negated bytes of a filter. 0: not negated; 1: negated.
                                         * CNcomment:过滤器取反字节,按byte设置, 0:不取反,1:取反
                                         */
} uapi_dmx_filter_attr;

/* Type of the DEMUX data packet..CNcomment:DEMUX数据包的类型 */
typedef enum {
    UAPI_DMX_DATA_TYPE_WHOLE = 0, /* The data segment contains a complete data packet.
                                     * CNcomment:此段数据包含完整的数据包, 对于SECTION每个包都是完整的
                                     */
    UAPI_DMX_DATA_TYPE_HEAD,      /* The data segment contains the head of a data packet,
                                     * but the data packet may not be complete.
                                     * CNcomment:此段数据包含数据包的起始，但是不一定是完整的包, 只用于PES数据
                                     */
    UAPI_DMX_DATA_TYPE_BODY,      /* This type is valid only for the PES data.The data segment contains the body
                                     * of a data packet.
                                     * CNcomment:此段数据包含数据包的内容，不包含起始，可能有结尾, 只用于PES数据
                                     */
    UAPI_DMX_DATA_TYPE_TAIL,      /* This type is valid only for the PES data.The data segment contains the tail
                                     * of a data packet, and is used to identify the end of a data packet.
                                     * CNcomment:此段数据包含数据包的结尾，用于指示可识别的包结束, 只用于PES数据
                                     */
    UAPI_DMX_DATA_TYPE_MAX
} uapi_dmx_data_type;

/* DEMUX data packet.CNcomment:DEMUX数据包结构 */
typedef struct {
    td_u8 *data;                    /* Data pointer.CNcomment:数据指针 */
    td_u32 size;                    /* Data length.CNcomment:数据长度 */
    uapi_dmx_data_type data_type; /* Data packet type.CNcomment:数据包的类型 */
} uapi_dmx_data;

/* type of record.CNcomment: 录制类型 */
typedef enum {
    UAPI_DMX_REC_TYPE_SELECT_PID, /* Record selected pid ts data.CNcomment: 录制指定PID TS数据 */
    UAPI_DMX_REC_TYPE_ALL_PID,    /* Record all pid ts data.CNcomment: 录制全码流TS数据 */
    UAPI_DMX_REC_TYPE_ALL_DATA,   /* Record raw data,TLV etc.CNcomment: 录制原始数据，如TLV等 */
    UAPI_DMX_REC_TYPE_MAX
} uapi_dmx_rec_type;

/* type of index.CNcomment: 索引类型 */
typedef enum {
    UAPI_DMX_REC_INDEX_TYPE_NONE,  /* No index is created.CNcomment: 不建索引 */
    UAPI_DMX_REC_INDEX_TYPE_VIDEO, /* Video index .CNcomment: 视频索引 */
    UAPI_DMX_REC_INDEX_TYPE_AUDIO, /* Audio index .CNcomment: 音频索引 */
    UAPI_DMX_REC_INDEX_TYPE_MAX
} uapi_dmx_rec_index_type;

/* TS stream type..CNcomment: ts码流的类型 */
typedef enum {
    UAPI_DMX_TS_PACKET_188, /* ts stream packet size of 188 bytes.CNcomment: ts码流包大小为188字节 */
    UAPI_DMX_TS_PACKET_192, /* ts stream packet size of 192 bytes.CNcomment: ts码流包大小为192字节 */
    UAPI_DMX_TS_PACKET_MAX
} uapi_dmx_ts_packet_type;

/* buffer attach type..CNcomment: buffer对接类型 */
typedef enum {
    UAPI_DMX_BUFFER_ATTACH_TYPE_TSR2RCIPHER, /* tsr2rcipher encrypt/decrypt.CNcomment: tsr2rcipher加解密 */
    UAPI_DMX_BUFFER_ATTACH_TYPE_CIPHER,      /* cipher encrypt/decrypt.CNcomment: cipher加解密 */
    UAPI_DMX_BUFFER_ATTACH_TYPE_MAX
} uapi_dmx_buffer_attach_type;

/* record attribute.CNcomment: 录制属性 */
typedef struct {
    td_u32 dmx_id;
    td_u32 rec_buf_size;                      /* Buffer size used by recordCNcomment: 录制缓存大小 */
    uapi_dmx_rec_type rec_type;             /* Record typeCNcomment: 录制类型 */
    td_bool descramed;                        /* TD_TRUE is the descrambled TS. TD_FALSE is the original TS.
                                               * CNcomment: TD_TRUE表示录制解扰后的TS流，TD_FALSE表示录制原始流
                                               */
    uapi_dmx_rec_index_type index_type;     /* Index typeCNcomment: 索引类型 */
    td_u32 index_src_pid;                     /* The index information is formed according to the PID.
                                               * when indexing video, it has to be set to the video of PID.
                                               * when indexing audio, it has to be set to the audio of PID.
                                               * CNcomment: 根据此PID生成索引数据，视频索引时设置为视频的PID，
                                               * 音频索引时设置为音频的PID
                                               */
    uapi_vcodec_type video_codec_type;      /* Video encoding protocol. The protocol needs to be set only when
                                               * the index type is UAPI_DMX_REC_INDEX_TYPE_VIDEO.
                                               * CNcomment: 视频索引时设置视频的编码类型
                                               */
    uapi_dmx_secure_mode secure_mode;       /* Secure record indication.CNcomment:安全录制标示 */
    uapi_dmx_ts_packet_type ts_packet_type; /* TS stream type of recorded TS.UAPI_DMX_TS_PACKET_192 is not
                                               * supported for full stream recording.
                                               * CNcomment: 录制生成文件中码流的TS类型。全码流录制时不支持
                                               * UAPI_DMX_TS_PACKET_192
                                               */
} uapi_dmx_rec_attr;

/* record data.CNcomment: 录制数据 */
typedef struct {
    td_u8 *data_addr;         /* Data address .CNcomment: 数据地址 */
    td_u32 len;               /* Data length .CNcomment: 数据长度 */
    td_bool last_data_flag;   /* Last Data Flag.CNcomment: 最后数据包标记 */
    td_mem_handle buf_handle; /* Es Buffer handle.CNcomment: Es Buffer句柄 */
} uapi_dmx_rec_data;

/* index data.CNcomment: 索引数据 */
typedef struct {
    uapi_video_frame_type frame_type; /* it is meaningless when indexing audio.CNcomment: 音频索引时无意义 */
    td_s64 pts_us;
    td_u64 global_offset;
    td_u32 frame_size; /* it is meaningless when indexing audio.CNcomment: 音频索引时无意义 */
    td_u32 data_time_ms;
} uapi_dmx_rec_index;

/* index and record data.CNcomment: 索引数据和录制数据 */
typedef struct {
    td_u32 index_num;      /* Number of index.CNcomment: 索引数据个数 */
    td_u32 rec_data_count; /* Number of record data block.
                            * CNcomment: 录制数据块个数,一般为1个，只有在当前录制数据一部分在录制buffer尾部，
                            * 一部分在头部的时候，会分成两个block 分别获取上来
                            */
    uapi_dmx_rec_index index[DMX_MAX_IDX_ACQUIRED_EACH_TIME];
    uapi_dmx_rec_data rec_data[DMX_MAX_REC_DATA_PARTS]; /* Recorded data can be reported in 2 parts at most.
                                                           * CNcomment: 录制数据最多分成两个block上报
                                                           */
} uapi_dmx_rec_data_index;

/* record buffer status.CNcomment: 录制缓冲区状态结构 */
typedef struct {
    td_u32 buffer_size; /* Buffer size.CNcomment:缓冲区大小 */
    td_u32 used_size;   /* Used buffer.CNcomment:缓冲区已使用大小 */
} uapi_dmx_rec_buf_status;

/* Repeat CC mode of channel.CNcomment:通道的CC重复模式 */
typedef enum {
    UAPI_DMX_CHAN_CC_REPEAT_MODE_RSV = 0x0,  /* Receive CC repeat ts packet.CNcomment:接收cc重复的ts包 */
    UAPI_DMX_CHAN_CC_REPEAT_MODE_DROP = 0x1, /* Drop CC repeat ts packet.CNcomment:丢弃cc重复的ts包 */
    UAPI_DMX_CHAN_CC_REPEAT_MODE_MAX = 0xFF
} uapi_dmx_chan_cc_repeat_mode;

typedef struct {
    td_handle chan;                                /* The channel handle.CNcomment:通道句柄 */
    uapi_dmx_chan_cc_repeat_mode cc_repeat_mode; /* Repeat CC mode of channel.CNcomment:通道的CC模式 */
} uapi_dmx_chan_cc_repeat_set;

/* PUSI (Payload Unit Start Index) config structure.CNcomment: PUSI 配置结构体 */
typedef struct {
    td_bool pusi; /* Value of Pusi, Default is TD_FALSE means receive ts packet without checking PUSI.
                   * CNcomment:NoPusiEn 的值，默认为 TD_FALSE 表示接收TS包的时候不检测PUSI标志
                   */
} uapi_dmx_pusi_set;

/* TEI (Transport Error Index) config structure.CNcomment: TEI 配置结构体 */
typedef struct {
    td_u32 dmx_id; /* The Subdiviece ID.CNcomment:Demux 子设备ID */
    td_bool tei;   /* Value of bTei, Default is TD_FALSE means receive ts packet even TEI equal 1.
                    * CNcomment:TEICfg 的值，默认为 TD_FALSE 表示接收TEI为1 的 TS包仍然接收
                    */
} uapi_dmx_tei_set;

typedef enum {
    UAPI_DMX_INVOKE_TYPE_CHAN_CC_REPEAT_SET = 0, /* dmx set channel extra attr, param:uapi_dmx_chan_cc_repeat_set.
                                                    * CNcomment:设置通道附加属性，使用参数uapi_dmx_chan_cc_repeat_set
                                                    */
    UAPI_DMX_INVOKE_TYPE_PUSI_SET,               /* dmx set PUSI flag, param:uapi_dmx_pusi_set.
                                                    * CNcomment: 设置 NoPusiEn 标志，使用参数uapi_dmx_pusi_set
                                                    */
    UAPI_DMX_INVOKE_TYPE_TEI_SET,                /* dmx set TEI flag, param:uapi_dmx_tei_set.
                                                    * CNcomment:设置Demux 子设备TEICfg 标志，使用参数uapi_dmx_tei_set
                                                    */
    UAPI_DMX_INVOKE_TYPE_TSI_ATTACH_TSO,         /* Attach TSI with TSO, param:TSI_ATTACH_TSO.
                                                    * CNcomment: 将TSI 与 某个 TSO 绑定,即: TSI 的码流来自 TSO ，
                                                    * 使用参数uapi_dmx_tei_set
                                                    */
    UAPI_DMX_INVOKE_TYPE_MAX
} uapi_dmx_invoke_type;

/* Define cb context type.CNcomment:定义回调上下文的类型 */
typedef enum {
    UAPI_DMX_CB_CONTEXT_TYPE_SHARED = 0, /* public shared context thread.CNcomment:共享的公共上下文 */
    UAPI_DMX_CB_CONTEXT_TYPE_PRIVATE,    /* private context thread.CNcomment:私有上下文 */
    UAPI_DMX_CB_CONTEXT_TYPE_MAX
} uapi_dmx_cb_context_type;

/* Declare section/pes/post cb function interface.CNcomment:声明section/pes/post通道的回调函数接口 */
typedef td_s32 (*uapi_dmx_chan_buf_cb_func)(td_handle chan, td_u32 acquire_num, uapi_dmx_data *buffer,
                                            td_void *user_data, td_u32 user_data_len);

/* Define cb descriptor.CNcomment:定义回调描述信息 */
typedef struct {
    uapi_dmx_cb_context_type context_type;    /* cb context type.CNcomment:回调上下文类型 */
    uapi_dmx_chan_buf_cb_func chan_buffer_cb; /* section/pes/post cb function.
                                                 * CNcomment:section/pes/post通道回调函数
                                                 */
    td_void *user_data;                         /* user private data.CNcomment:用户私有信息 */
    td_u32 user_data_len;                       /* user data length.CNcomment:用户信息长度> */
} uapi_dmx_cb_desc;


/* Initializes the DEMUX module.CNcomment:初始化DEMUX模块。
 * Before using DEMUXs, you must call this application programming interface (API)
 * Before using the personal video recorder (PVR) or audio/video player (AVPLAY),
 * you need to initialize the DEMUX module.
 * The error code TD_SUCCESS is returned if this API is called repeatedly.
 * CNcomment:在进行DEMUX相关操作前应该首先调用本接口
 * 在使用PVR和AVPLAY前请提前进行DEMUX模块的初始化
 * 重复调用本接口返回成功。
 * param  * retval ::TD_SUCCESS Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 */
td_s32 uapi_dmx_init(td_void);

/*
 * brief Deinitializes the DEMUX module. CNcomment:去初始化DEMUX模块。
 * After this API is called, the DEMUX module is stopped, and the DEMUX resources used by the process are released.
 * This API is valid when it is called for the first time. If this API is called repeatedly,
 * the error code TD_SUCCESS is returned.
 * CNcomment:调用本接口停止使用DEMUX模块，并释放本进程所占用的DEMUX资源
 * 本接口第一次调用起作用，重复调用返回成功。
 * param  *retval ::TD_SUCCESS Success CNcomment:成功。
 * retval ::TD_FAILURE Calling this API fails. CNcomment:API系统调用失败。
 */
td_s32 uapi_dmx_deinit(td_void);

/*
 * brief Obtains the information about the service capabilities of the DEMUX module.
 * The information includes the numbers of channels, filters, keys, ports, DEMUXs, and audio/video channels.
 * CNcomment:查询DEMUX模块业务能力。
 * 业务功能包括通用通道数目、过滤器数目、密钥数目、端口数目、DEMUX设备数目和音视频通道数目等。
 * param[out] capability Pointer to the capability of the DEMUX module (output).CNcomment:指针类型，输出DEMUX模块能力。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null.CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_capability(uapi_dmx_capability *capability);

/*
 * brief Sets the tsi port attr corresponding to demod.CNcomment:设置demod对应的tsi端口属性。
 * param[in] demod_id    Demod ID.CNcomment:demod号。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_attach_demod(td_u8 demod_id);

/*
 * brief Obtains the attributes of a DEMUX port.CNcomment:获取DEMUX端口属性。
 * param[in] id    Port ID.CNcomment:端口号。
 * param[out] attr Pointer to the port attributes (output).CNcomment:指针类型，输出端口属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null.CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_ts_port_attr(uapi_dmx_port id, uapi_dmx_port_attr *attr);

/*
 * brief Sets the attributes of a DEMUX port.CNcomment:设置DEMUX端口属性。
 * It is recommended to query the default attributes of a DEMUX port by calling uapi_dmx_get_ts_port_attr
 * before modifying the attributes of the port.
 * The port mode can be queried only, notice that it will lose TS data if call this function during receiving data.
 * If the sync loss threshold and sync lock threshold are used, their default values are recommended.
 * For details on how to set the input clock of the tuner, select the line sequence of the port,
 * and set the level of the tuner error line, contact hardware engineers of Huanglong and refer to tuner user manuals.
 * If ramport, it must be called after UAPI_DMX_CreateTSBuffer.
 * CNcomment:建议先通过uapi_dmx_get_ts_port_attr获取默认属性，然后对要改变的属性进行设置
 * 端口模式只支持查询，不支持修改，注意收数据过程调用该接口会引起丢TS包
 * 同步丢失和同步锁定门限，推荐使用默认值
 * tuner输入时钟反向、端口线序选择和tuner error线电平模式的设置请咨询硬件工程师
 * 并参考tuner的用户手册，然后设置为合适的值
 * 针对ramport，本接口需要在UAPI_DMX_CreateTSBuffer之后调用。
 * param[in] id    Port ID.CNcomment:端口号。
 * param[in] attr  Pointer to port attributes.CNcomment:指针类型，端口属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_set_ts_port_attr(uapi_dmx_port id, const uapi_dmx_port_attr *attr);

/*
 * brief Obtains the attributes of a DEMUX TSO port.CNcomment:获取DEMUX TS输出端口属性。
 * param[in] id    Port ID.CNcomment:端口号。
 * param[out] attr Pointer to the port attributes (output).CNcomment:指针类型，输出端口属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null.CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_tso_port_attr(uapi_dmx_tso_port id, uapi_dmx_tso_port_attr *attr);

/*
 * brief Sets the attributes of a DEMUX TSO port.CNcomment:设置DEMUX TS 输出端口属性。
 * It is recommended to query the default attributes of a DEMUX TSO port by calling uapi_dmx_get_tso_port_attr
 * before modifying the attributes of the TSO port.
 * CNcomment:建议先通过uapi_dmx_get_tso_port_attr获取默认属性，然后对要改变的属性进行设置。
 * param[in] id   Port ID.CNcomment:端口号。
 * param[in] attr Pointer to port attributes.CNcomment:指针类型，端口属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_set_tso_port_attr(uapi_dmx_tso_port id, const uapi_dmx_tso_port_attr *attr);

/*
 * brief Get the tag attributes.CNcomment:获取tag 的相关属性。
 * pstAttr.au8Tag is a key index, this interface will return corresponding tag attrs if this key value has registered,
 * otherwise return default tag attrs.
 * CNcomment:pstAttr.au8Tag参数是一个索引，这个接口会返回对应的tag参数如果这个索引已经被注册，
 * 否则的话返回默认的tag属性配置。
 * param[in] id TagPort ID.CNcomment:TapPort ID号。
 * param[in & out] attr Pointer to the tag port attributes (output).CNcomment:指针类型，tag端口属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_get_tag_port_attr(uapi_dmx_port id, uapi_dmx_tag_attr *attr);

/*
 * brief Set the tag attributes.CNcomment:设置tag的相关属性。
 * pstAttr.au8Tag is a key index, it will register this new tag if this key value has not registered.
 * otherwise increase tag reference number.
 * N/A.CNcomment:pstAttr.au8Tag参数是一个索引，这个接口会注册新的tag值如果tag未被注册的话，否则会增加tag的应用计数。
 * param[in] id TagPort ID.CNcomment:TapPort ID号。
 * param[in] attr Pointer to the tag port attributes (output).CNcomment:指针类型，tag端口属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_set_tag_port_attr(uapi_dmx_port id, const uapi_dmx_tag_attr *attr);

/*
 * brief Attaches a DEMUX to a port.CNcomment:绑定DEMUX到端口上。
 * Each DEMUX can be attached to only one port, but the data from a port can be delivered to multiple DEMUXs.
 * After a DEMUX is attached to a port, the DEMUX starts to receive the data input from this port.
 * If the DEMUX is not used, you can detach it by calling UAPI_DMX_DetachTSPort.
 * The DEMUXs can be attached to different ports dynamically. That is, you can attach the DEMUXs without detaching them.
 * If you call this API to attach a DEMUX to the same channel, the error code TD_SUCCESS is returned.
 * If ramport, it must be called before uapi_dmx_create_ts_buffer.
 * CNcomment:每路DEMUX只能绑定到一个PORT，但是一个PORT的数据可以分发到多个DEMUX
 * DEMUX绑定到端口上之后就开始接收这个端口上输入的数据
 * 不再使用这路DEMUX接收数据后，使用UAPI_DMX_DetachTSPort接口解绑定DEMUX
 * 可以动态的绑定到不同的端口上，不用先解绑定
 * 重复调用此接口绑定到相同通道上返回成功
 * 针对ramport，本接口需要在uapi_dmx_create_ts_buffer之前调用。
 * param[in] dmx_id  DEMUX ID.CNcomment:DEMUX号。
 * param[in] id Port ID.CNcomment:端口号。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_attach_ts_port(td_u32 dmx_id, uapi_dmx_port id);

/*
 * brief Detaches a DEMUX from a port.CNcomment:从端口上解绑定DEMUX。
 * If a DEMUX is not used, you can detach it from the corresponding port by calling this API.
 * This API can be called dynamically, and can be used to disable the input sources of a DEMUX.
 * If this API is called repeatedly, the error code TD_SUCCESS is returned.
 * CNcomment:不再使用DEMUX接收任何数据时使用此接口将DEMUX从端口上解绑定
 * 可以动态使用解绑定接口，可以通过解绑定接口切断DEMUX的输入源
 * 重复解绑定返回成功。
 * param[in] dmx_id  DEMUX ID. CNcomment: DEMUX号。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_detach_ts_port(td_u32 dmx_id);

/*
 * brief Obtains the ID of the port that is attached to a DEMUX. CNcomment:获取DEMUX所绑定的端口的端口号。
 * If a DEMUX is not attached to any port, an error code is
 * returned.CNcomment:如果DEMUX没有绑定到任何端口上会返回错误码。 param[in] dmx_id  DEMUX ID. CNcomment: DEMUX号。
 * param[out] id Pointer to the ID of the port that is attached to a DEMUX(output).
 * CNcomment:指针类型，输出DEMUX绑定的端口号。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOATTACH_PORT  The DEMUX is not attached to any port.CNcomment:此路DEMUX没有绑定到任何端口上。
 */
td_s32 uapi_dmx_get_ts_port_id(td_u32 dmx_id, uapi_dmx_port *id);

/*
 * brief Obtains the default attributes of a TS Buffer.CNcomment:获取TS Buffer默认属性。
 * It is recommended to query the default TS Buffer attributes before creating a TS Buffer,
 * and then modify the attributes, notice the secure mode of default attributes is None Secure Mode.
 * CNcomment:最好在申请TS Buffer之前使用此接口获取默认属性，
 * 然后改变需要修改的属性即可，注意默认属性为非安全模式。
 * param[out] buffer_attr Pointer to the structure of the TS Buffer attributes.CNcomment:TS Buffer属性结构体指针。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_ts_buffer_default_attr(uapi_dmx_ts_buffer_attr *buffer_attr);

/*
 * brief Creates a TS buffer for the RAM port to receive the TS data from Internet or local memory.
 * CNcomment:为RAM端口创建TS Buffer用于接收从网络或本地存储中输入的TS数据。
 * A TS buffer can be created for the RAM port only.
 * The buffer size must range from 4 KB to 16 MB.
 * It is recommended to set the buffer size to an integral multiple of 4 KB.
 * Otherwise, bottom alignment is performed inside.
 * The TS buffer cannot be created for the same port for multiple times; otherwise, an error code is returned.
 * CNcomment:只有RAM端口可以创建TS Buffer
 * buffer大小必须在4K和16M之间，单位为字节
 * buffer大小最好为4K的整数倍，如果不是整数倍，内部会进行向下对齐操作
 * 同一个端口不能重复创建TS Buffer,否则返回错误码。
 * param[in] id Port ID.CNcomment:端口号。
 * param[in] ts_buffer_attr Attributes of a TS buffer.CNcomment:TS Buffer创建属性。
 * param[out] ts_buffer Pointer to the handle of a created TS buffer (output).
 * CNcomment:指针类型，输出创建的TS Buffer 句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_RECREAT_TSBUFFER  The TS buffer corresponding to the port is created.CNcomment:重复创建TS
 * Buffer。
 */
td_s32 uapi_dmx_create_ts_buffer(uapi_dmx_port id, const uapi_dmx_ts_buffer_attr *ts_buffer_attr,
    td_handle *ts_buffer);

/*
 * brief Destroys an existing TS buffer. CNcomment:销毁创建的TS Buffer。
 * A TS buffer cannot be destroyed repeatedly. If a TS buffer is destroyed, its handle is also destroyed.
 * In addition, if a buffer is destroyed, its data is cleared. In this case, the get and put operations are not
 * available.However, the data in channels is retained when a TS buffer is destroyed. To switch streams,
 * you need disable the channel, and then enable the channel again.
 * CNcomment:不能重复销毁一个TS Buffer,销毁之后handle就不存在了
 * 销毁之后buffer中的数据就会被清空，不能再进行Get和Put操作
 * 销毁TS buffer并不能清空通道中数据，要切换码流，要注意关闭通道，重新打开。
 * param[in] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_destroy_ts_buffer(td_handle ts_buffer);

/*
 * brief Attach demux handle and releated secure buffer to session manager.
 * CNcomment:将demux句柄及相应安全buffer绑定到 session manager。
 * The demux handle should be tsbuffer handle.
 * CNcomment:此处demux句柄为tsbuffer句柄。
 * param[in] handle      Tsbuffer handle. CNcomment:Tsbuffer句柄。
 * param[in] ssm_handle  Session manager handle. CNcomment:session manager句柄。
 * param[in] attach_type Buffer attach type. CNcomment:buffer绑定类型。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_ts_buffer_attach_ssm(td_handle handle, td_handle ssm_handle,
    uapi_dmx_buffer_attach_type attach_type);

/*
 * brief Behavior1, Default,need work with uapi_dmx_put_ts_buffer. Obtains a TS buffer to input data.
 * CNcomment:行为一，默认模式，需要和uapi_dmx_put_ts_buffer配合使用。获取TS Buffer空间，用于数据输入。
 * If you call this API repeatedly, the address of the same buffer is returned.
 * The input data length must be appropriate. If the data length is too large, data cannot be input in time.
 * If the data length is too small,the buffer is scheduled frequently,
 * which causes the system performance to deteriorate.
 * If the size of the available space is smaller than the requested data length, an error code is returned.
 * To be specific, the requested data length must be smaller than the size of the available space, that is,
 * the buffer cannot be full.
 * In addition, the requested data length cannot be 0; otherwise, the error code SOC_ERR_DMX_INVALID_PARA is returned.
 * If timeout_ms is set to 0, it indicates that the waiting time is 0; if timeout_ms is set to 0XFFFFFFFF,
 * it indicates infinite wait;if timeout_ms is set to other values,it indicates that the waiting time is timeout_ms ms.
 * If no buffer can be applied for during the block period, the error code SOC_ERR_DMX_TIMEOUT is returned.
 * If timeout_ms is set to 0, and no buffer can be applied for, it indicates that the internal TS buffer is full.
 * In this case,you need to call the usleep(10000) function to release the CPU.
 * Therefore,other threads can be scheduled.
 * CNcomment:重复get返回同一个buffer地址
 * 输入数据时注意每次输入的数据长度，太长可能会导致输入数据不及时
 * 太短可能会导致调度太频繁，性能下降
 * 当剩余空间小于等于请求的长度时，返回错误码
 * 每次申请的长度要小于剩余剩余长度，即buffer不可能被填满
 * 请求长度不允许为0，否则返回参数非法错误码
 * timeout_ms设置为0表示不等待，设置为0xffffffff表示一直等待，设置为其他值表示等待timeout_ms毫秒。
 * 若超过阻塞时间，还无法申请到Buffer，则返回SOC_ERR_DMX_TIMEOUT错误码
 * timeout_ms配置为0时，如果申请不到Buffer，说明此时内部TS Buffer空间已满，需要通过usleep(10000)释放cpu
 * 以使其它线程能够得到调度。
 * param[in] hTsBuffer     Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[in] u32ReqLen     Requested data length.CNcomment:请求数据的长度。
 * param[out] pstData      Data buffer.CNcomment:数据buffer结构。
 * param[in] timeout_ms  Wait timeout, in ms.CNcomment:等待超时时间，单位ms。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_TIMEOUT  The wait times out. CNcomment:等待超时。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_BUF  The size of the available buffer is smaller than the requested data length.
 * CNcomment:剩余buffer空间小于请求长度。

 * Behavior2,Support multrtherad operate one tsbuffer,Only Valid wen CFG_DMX_TSBUF_MULTI_THREAD_SUPPORT=y,
 * need work with uapi_dmx_put_ts_buffer and uapi_dmx_release_ts_buffer. Obtains a TS buffer to input data.
 * CNcomment:行为二，支持多线程操作同一个TSbuffer模式，仅当CFG_DMX_TSBUF_MULTI_THREAD_SUPPORT=y有效，
 * 需要和uapi_dmx_put_ts_buffer、uapi_dmx_release_ts_buffer配合使用。获取TS Buffer空间，用于数据输入。
 * If you call this API repeatedly and didn't call uapi_dmx_release_ts_buffer,
 * the address of the different buffer block
 * is returned and memory leak will be happened, this function must be couple with UAPI_DMX_ReleaseTSBuffer.
 * The input data length must be appropriate. If the data length is too large, data cannot be input in time.
 * If the data length is too small, the buffer is scheduled frequently,
 * which causes the system performance to deteriorate.
 * If the size of the available space is smaller than the requested data length, an error code is returned.
 * To be specific, the requested data length must be smaller than the size of the available space, that is,
 * the buffer cannot be full.
 * In addition, the requested data length cannot be 0; otherwise, the error code SOC_ERR_DMX_INVALID_PARA is returned.
 * If timeout_ms is set to 0, it indicates that the waiting time is 0; if timeout_ms is set to 0XFFFFFFFF,
 * it indicates infinite wait;if timeout_ms is set to other values,it indicates that the waiting time is timeout_ms ms.
 * If no buffer can be applied for during the block period, the error code SOC_ERR_DMX_TIMEOUT is returned.
 * If timeout_ms is set to 0, and no buffer can be applied for, it indicates that the internal TS buffer is full.
 * In this case,you need to call the usleep(10000) function to release the CPU.Therefore,other threads can be scheduled.
 * CNcomment:重复get返回不同buffer块的地址，并且如果本接口调用成功而不调用UAPI_DMX_ReleaseTSBuffer，
 * 则会引起内存泄漏，所以只要本接口调用成功，必须调用uapi_dmx_release_ts_buffer确保buffer块正确释放。
 * 输入数据时注意每次输入的数据长度，太长可能会导致输入数据不及时
 * 太短可能会导致调度太频繁，性能下降
 * 当剩余空间小于等于请求的长度时，返回错误码
 * 每次申请的长度要小于剩余剩余长度，即buffer不可能被填满
 * 请求长度不允许为0，否则返回参数非法错误码
 * timeout_ms设置为0表示不等待，设置为0xffffffff表示一直等待，设置为其他值表示等待timeout_ms毫秒。
 * 若超过阻塞时间，还无法申请到Buffer，则返回SOC_ERR_DMX_TIMEOUT错误码
 * timeout_ms配置为0时，如果申请不到Buffer，说明此时内部TS Buffer空间已满，需要通过usleep(10000)释放cpu
 * 以使其它线程能够得到调度。
 * param[in] ts_buffer   Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[in] req_len     Requested data length.CNcomment:请求数据的长度。
 * param[out] ts_stream  Data buffer.CNcomment:数据buffer结构。
 * param[in] timeout_ms  Wait timeout, in ms.CNcomment:等待超时时间，单位ms。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_TIMEOUT  The wait times out. CNcomment:等待超时。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_BUF  The size of the available buffer is smaller than the requested data length.
 * CNcomment:剩余buffer空间小于请求长度。
 */
td_s32 uapi_dmx_get_ts_buffer(td_handle ts_buffer, td_u32 req_len, uapi_stream_buf *ts_stream, td_u32 timeout_ms);

/*
 * brief Updates the write pointer of a TS buffer after the TS data is input.
 * CNcomment:TS数据输入完毕，用于更新TS Buffer写指针。
 * This API must work with uapi_dmx_get_ts_buffer. That is, if you call uapi_dmx_put_ts_buffer without calling
 * uapi_dmx_get_ts_buffer, no operation takes effect, but the error code TD_SUCCESS is returned.
 * If the valid data length is 0, no operation takes effect, and the error code TD_SUCCESS.
 * The valid data length cannot be greater than data length queried by calling uapi_dmx_get_ts_buffer.
 * Otherwise, the error code SOC_ERR_DMX_INVALID_PARA is returned.
 * If the valid data length is smaller than the data length queried by calling uapi_dmx_get_ts_buffer,
 * it indicates that a part of data is stored.
 * CNcomment:此接口必须和Get接口配对使用，如果没有Get则进行Put操作，则不会进行任何操作，但返回成功
 * Put的长度如果为0，也不会进行任何操作直接返回成功
 * 不允许Put长度大于实际Get到的长度，否则返回参数非法错误码
 * 允许Put长度小于Get长度，表明只输入了一部分数据
 * 为提高效率，Put的长度尽量不要太短，尽量保持在10个ts包以上Put一次，数据太短会导致性能下降。
 * param[in] ts_buffer      Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[in] valid_data_len Valid data length.CNcomment:有效数据的长度。
 * param[in] start_pos      Start position of the valid data. CNcomment:有效数据的起始位置。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_put_ts_buffer(td_handle ts_buffer, td_u32 valid_data_len, td_u32 start_pos);

/*
 * brief Only valid when CFG_DMX_TSBUF_MULTI_THREAD_SUPPORT=y Updates the write pointer of a TS buffer after
 * the TS data is input.CNcomment:TS数据输入完毕，用于更新TS Buffer写指针。
 * This API must work after uapi_dmx_get_ts_buffer success. That is, if you call uapi_dmx_push_ts_buffer
 * without calling uapi_dmx_get_ts_buffer, no operation takes effect, but the error code TD_SUCCESS is returned.
 * If the valid data length is 0, no operation takes effect, and the error code TD_SUCCESS.
 * The valid data length cannot be greater than data length queried by calling uapi_dmx_get_ts_buffer.
 * Otherwise, the error code SOC_ERR_DMX_INVALID_PARA is returned.
 * If the valid data length is smaller than the data length queried by calling uapi_dmx_get_ts_buffer,
 * it indicates that a part of data is stored.
 * CNcomment:此接口必须在Get接口调用成功后使用，如果没有Get则进行Push操作，则不会进行任何操作，但返回成功
 * Put的长度如果为0，也不会进行任何操作直接返回成功
 * 不允许Push长度大于实际Get到的长度，否则返回参数非法错误码
 * 允许Push长度小于Get长度，表明只输入了一部分数据
 * 为提高效率，Push的长度尽量不要太短，尽量保持在10个ts包以上Push一次，数据太短会导致性能下降。
 * param[in] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[in] ts_stream Pointer that point to uapi_stream_buf.CNcomment:指向uapi_stream_buf类型的结构体指针。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_push_ts_buffer(td_handle ts_buffer, const uapi_stream_buf *ts_stream);

/*
 * brief Only valid when CFG_DMX_TSBUF_MULTI_THREAD_SUPPORT=y Release the Ts buffer Get by  uapi_dmx_get_ts_buffer.
 * CNcomment:释放由uapi_dmx_get_ts_buffer接口申请的TS buffer空间。
 * This API must work with uapi_dmx_get_ts_buffer. That is, you must call uapi_dmx_release_ts_buffer,
 * if uapi_dmx_get_ts_buffer has success,if not, there will be memory leak happened.
 * The valid data length cannot be greater than data length queried by calling uapi_dmx_get_ts_buffer.
 * Otherwise, the error code SOC_ERR_DMX_INVALID_PARA is returned.
 * If the valid data length must be same as the data length queried by calling uapi_dmx_get_ts_buffer.
 * CNcomment:此接口必须和Get接口配对使用，换句话说uapi_dmx_get_ts_buffer调用成功后必须调用本接口释放buffer，
 * 否则将有内存泄漏发生。
 * 不允许Release长度大于实际Get到的长度，否则返回参数非法错误码
 * Release长度必须和Get的长度一致。
 * param[in] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[in] ts_stream Pointer that point to uapi_stream_buf.CNcomment:指向uapi_stream_buf类型的结构体指针。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_release_ts_buffer(td_handle ts_buffer, const uapi_stream_buf *ts_stream);

/*
 * brief Wait until tsbuffer stream has been consumed completely.CNcomment:等待tsbuffer里的码流数据消耗完成。
 * param[in] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_flush_ts_buffer(td_handle ts_buffer);

/*
 * brief Resets a TS buffer to clear its data.CNcomment:复位TS Buffer，清空TS Buffer中的数据。
 * If a TS buffer is reset, you can call uapi_dmx_put_ts_buffer only after calling uapi_dmx_get_ts_buffer.
 * CNcomment:TS Buffer复位后需要重新get才能执行put操作。
 * param[in] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_reset_ts_buffer(td_handle ts_buffer);

/*
 * brief Obtains the status of a TS buffer. CNcomment:获取TS Buffer状态。
 * You can query the size of a TS buffer and the used buffer size by calling this API.
 * CNcomment:可以查询TS Buffer大小和已用的空间大小。
 * param[in] ts_buffer          Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[out] ts_buffer_status  TS buffer status.CNcomment:TS Buffer状态结构。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_ts_buffer_status(td_handle ts_buffer, uapi_dmx_ts_buffer_status *ts_buffer_status);

/*
 * brief Obtains the ID of the port corresponding to a TS buffer.CNcomment:获取TS Buffer对应的Port ID。
 * If you query the ID of the port corresponding to a TS buffer that is not applied for successfully,
 * an error code is returned.
 * CNcomment:对于没有申请的TS buffer,查询会返回错误。
 * param[in] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * param[out] id  ID of the port.corresponding to a TS buffer  CNcomment:TS Buffer对应的Port ID。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_ts_buffer_port_id(td_handle ts_buffer, uapi_dmx_port *id);

/*
 * brief Obtains the handle of the TS buffer corresponding to a port ID.CNcomment:获取Port ID对应的TS Buffer handle。
 * If you obtain the handle of a TS buffer that is not created, an error code is returned.
 * CNcomment:对于没有申请的TS buffer,查询会返回错误。
 * param[in] id         Port ID. CNcomment:端口号。
 * param[out] ts_buffer Handle of a TS buffer.CNcomment:TS Buffer句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_ts_buffer_handle(uapi_dmx_port id, td_handle *ts_buffer);

/*
 * brief Obtains the information about TS packets of a port.CNcomment:获取端口的TS包信息。
 * If you query the information about an unattached port, an error code is returned.
 * CNcomment:对于没有绑定的端口,查询会返回错误。
 * param[in] id             Port ID. CNcomment:端口号。
 * param[out] port_status   Number of TS packets .CNcomment:TS包计数信息。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_ts_port_packet_num(uapi_dmx_port id, uapi_dmx_port_packet_num *port_status);

/*
 * brief Obtains the default attributes of a channel.CNcomment:获取通道默认属性。
 * It is recommended to query the default channel attributes before creating a channel, and then modify the attributes.
 * By default, the attributes of the Section channel are returned. If other channels are used,
 * you need to modify the attributes.
 * CNcomment:最好在申请通道之前使用此接口获取默认属性，然后改变需要修改的属性即可
 * 默认属性按一般的section通道返回的，如果要使用其他类型的通道注意修改属性值。
 * param[out] play_chan_attr Pointer to the structure of the channel attributes.CNcomment:通道属性结构体指针。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_play_chan_default_attr(uapi_dmx_chan_attr *play_chan_attr);

/*
 * brief Creates a play channel based on channel attributes.CNcomment:根据通道属性创建一个播放通道。
 * It is recommended to call uapi_dmx_get_play_chan_default_attr to query default channel attributes before calling
 * uapi_dmx_create_play_chan.
 * For the Section channel and ECM/EMM channel, you can set the CRC mode, and dynamically change the CRC mode by calling
 * uapi_dmx_get_play_chan_attr.
 * For other channels, the CRC check is always disabled. If you select other CRC modes,
 * the CRC disable mode takes effect by default.
 * You need to set the buffer size when creating a channel. The buffer size is in the unit of byte and the default size
 * is 16 KB.
 * It is recommended to set the buffer size to a value greater than 4 KB for the Section channel, ECM/EMM channel,
 * or post channel. If the buffer size is smaller than 4 KB, the size of 4 KB is used by default.
 * It is recommended to set the buffer size to a value greater than 64 KB for the PES channel.
 * If the buffer size is smaller than 64 KB, the size of 64 KB is used by default.
 * CNcomment:建议调用此接口之前，建议先调用uapi_dmx_get_play_chan_default_attr获取通道默认属性
 * 只有section类型的通道和ecm emm类型的通道支持设置CRC模式，并且可以通过属性设置接口动态修改CRC模式
 * 其他类型通道只支持设置为CRC禁止，如果选择了其他类型的CRC会被默认修改为CRC禁止
 * 在申请通道时注意Buffer大小的配置，默认大小为16K，buffer大小的单位为字节
 * Section、ecm emm和POST通道的buffer大小至少为4K，如果小于4K会被默认修改为4K
 * PES通道建议使用64K以上的buffer大小，如果小于64K会被默认修改为64K
 * param[in] dmx_id      DEMUX ID. CNcomment: DEMUX号。
 * param[in] chan_attr   Pointer to the attributes of an input channel.For details,
 * see the description of  i_iapi_dmx_chan_attr.CNcomment:指针类型，输入通道属性。请参见::uapi_dmx_chan_attr。
 * param[out] play_chan  Pointer to the handle of an allocated channel.CNcomment:指针类型，输出分配的通道Handle。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOFREE_CHAN  There is no available channel.CNcomment:没有空闲通道。
 */
td_s32 uapi_dmx_create_play_chan(td_u32 dmx_id, const uapi_dmx_chan_attr *play_chan_attr, td_handle *play_chan);

/*
 * brief Destroys an existing play channel.CNcomment:销毁创建的播放通道。
 * If you release an enabled channel, the channel is disabled automatically. If you release a channel that is attached
 * to a filter or key area, the channel is detached from the filter or key area automatically.
 * However, the filter or key area is not released.
 * It is recommended to explicitly detach channels by calling corresponding detach APIs. In this way, resources are
 * managed in a unified manner.
 * CNcomment:释放通道时如果通道处于打开状态会自动关闭通道，如果通道上绑定了过滤器或密钥区，会自动解绑定
 * 但是并不会释放过滤器和密钥区
 * 建议使用解绑定接口进行显式的解绑定操作，对资源的使用进行清晰的管理。
 * param[in] play_chan  Play channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_destroy_play_chan(td_handle play_chan);

/*
 * brief Attach demux handle and releated secure buffer to session manager.CNcomment:将demux句柄及相应安全buffer绑定到
 * session manager。
 * The demux handle should be play channel handle.
 * CNcomment:此处demux句柄为播放句柄。
 * param[in] play_chan   Play channel handle. CNcomment:播放通道句柄。
 * param[in] ssm_handle  Session manager handle. CNcomment:session manager句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_play_chan_attach_ssm(td_handle play_chan, td_handle ssm_handle);

/*
 * brief Obtains the attributes of a play channel.CNcomment:获取播放通道属性。
 * The API can be called only after a channel is allocated.CNcomment:本接口必须在通道分配以后才可以调用。
 * param[in] play_chan   Channel handle.CNcomment:通道Handle。
 * param[out] chan_attr  Pointer to the attributes of a specified channel. For details,
 * see the description of uapi_dmx_chan_attr.CNcomment:指针类型，输出指定通道属性。请参见::uapi_dmx_chan_attr。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_play_chan_attr(td_handle play_chan, uapi_dmx_chan_attr *chan_attr);

/*
 * brief Sets the attributes of a play channel.CNcomment:设置播放通道属性。
 * The API can be called only after a channel is allocated.
 * You cannot dynamically modify all attributes except the CRC mode by calling uapi_dmx_set_play_chan_attr.
 * To be specific, the CRC mode can be changed dynamically after a channel is created.
 * If you modify other attributes, the error code SOC_ERR_DMX_INVALID_PARA is returned.
 * CNcomment:本接口必须在通道分配以后才可以调用
 * 除了CRC模式其他属性都不允许使用uapi_dmx_set_play_chan_attr接口进行动态修改
 * CRC模式可以在通道申请后的任意时刻修改，动态生效
 * 要修改其他属性会返回参数非法错误码。
 * param[in] play_chan   Channel handle.CNcomment:通道句柄。
 * param[in] chan_attr   Pointer to the attributes of an input channel. For details, see the description of
 * uapi_dmx_chan_attr.  CNcomment:指针类型，输入通道属性。请参见 ::uapi_dmx_chan_attr。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_set_play_chan_attr(td_handle play_chan, const uapi_dmx_chan_attr *chan_attr);

/*
 * brief Sets the PID of a play channel.CNcomment:设置播放通道PID。
 * If you set the same PID for two channels of a DEMUX, the PID of the second channel is valid,
 * and the PID of the first channel is changed to 0x1FFF.
 * You must set the PID of a channel after the channel is disabled.
 * If you set the PID of a channel to 0x1FFF, the channel cannot receive data. That is, the channel is disabled.
 * CNcomment:同一路DEMUX的两个通道设置相同的PID。后设置的通道有效，先设置的通道的PID被修改为0x1fff
 * 必须在通道关闭的状态下配置通道的PID
 * 允许将通道的PID配置为0x1fff,配置为0x1fff后不接收任何数据，相当于关闭通道。
 * param[in] play_chan   Channel handle.CNcomment:通道句柄。
 * param[in] pid         Channel PID.CNcomment:通道PID。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_OPENING_CHAN  The channel is enabled.CNcomment:通道处于打开状态。
 */
td_s32 uapi_dmx_set_play_chan_pid(td_handle play_chan, td_u32 pid);

/*
 * brief Obtains the PID of a play channel.CNcomment:获取播放通道配置的PID。
 * If no PID is set for a channel, the obtained value is 0x1FFF.
 * You can obtain the channel PID after a channel is created.
 * CNcomment:没有配置PID前，获取到的PID为0x1fff
 * 可以在通道申请后的任意时刻获取通道PID。
 * param[in] play_chan  Channel handle.CNcomment:通道句柄。
 * param[out] pid       Pointer to the PID of a channel (output).CNcomment:指针类型，输出通道的PID。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_play_chan_pid(td_handle play_chan, td_u32 *pid);

/*
 * brief Enables a paly channel.CNcomment:打开播放通道。
 * If you call this API to enable a play channel that has been enabled, no error occurs.
 * If you call this API to enable a Section channel that is not attached to a filter, the channel cannot receive data.
 * If you want to receive data without filter, you can create a filter and then set its filter depth to 0.
 * CNcomment:在播放通道打开状态下，调用本接口打开通道不会发生错误
 * 对于section通道，在通道没有绑定过滤器时调用本接口，通道不能接收数据
 * 如果不想使用filter接收数据，可以申请一个filter将过滤深度配置为0，进行数据接收。
 * param[in] play_chan  Channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_open_play_chan(td_handle play_chan);

/*
 * brief Disables a play channel.CNcomment:关闭播放通道。
 * If you this API to disable a play channel that has been disabled, no error occurs.
 * CNcomment:在播放通道关闭状态下，调用本接口关闭通道不会发生错误。
 * param[in] play_chan   Channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_close_play_chan(td_handle play_chan);

/*
 * brief Obtains the status of a play channel.CNcomment:获取播放通道状态。
 * You can call this API after a channel is created.CNcomment:可以在通道申请后的任意时刻调用。
 * param[in] chan          Channel handle.CNcomment:通道句柄。
 * param[out] chan_status  Pointer to the status of a channel (output). For details,
 * see the description of ::uapi_dmx_chan_status.CNcomment:指针类型，输出通道状态。请参见::uapi_dmx_chan_status
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_play_chan_status(td_handle play_chan, uapi_dmx_chan_status *chan_status);

/*
 * brief Obtains the handle of the pid channel with a specific PID.CNcomment:获取配置某PID的通道句柄。
 * You must specify the DEMUX ID when calling this API, because the channel PIDs of different DEMUXs can be the same.
 * You cannot query the PID that is equal to or greater than 0x1FFF; otherwise, the error code
 * SOC_ERR_DMX_INVALID_PARA is returned.
 * If no channel with a specific PID is found, an error code is returned.
 * CNcomment:因不同DEMUX设备的通道允许设置相同的PID，调用本接口需要指定DEMUX ID
 * 不允许查询0x1fff及以上的非法PID值，否则返回参数非法错误码
 * 如果没有查询到任何通道设置了要查询的PID，将返回错误码。
 * param[in] dmx_id       DEMUX ID. CNcomment: DEMUX号。
 * param[in] pid          Channel PID.CNcomment:通道PID。
 * param[out] pid_channel Pointer to channel handle.CNcomment: 指针类型，输出通道Handle。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_UNMATCH_CHAN  No matched channel is found.CNcomment:没有查询到匹配通道。
 * retval ::SOC_ERR_DMX_OCCUPIED_PID  The same pid was found on multiple channels.CNcomment:在多个通道上发现了相同的PID。
 */
td_s32 uapi_dmx_get_pid_chan_handle(td_u32 dmx_id, td_u32 pid, td_handle *pid_chan);

/*
 * brief Obtains the number of available channels of a DEMUX.CNcomment:获取DEMUX设备可用的空闲通道的数量。
 * The returned number is the number of all remaining channels including the used audio/video channels.
 * Because channels are allocated in a unified manner, the parameter u32DmxId is invalid.
 * CNcomment:返回的数量为所有通道剩余的数量，包括已被使用的音视频通道
 * 由于通道资源统一分配所以参数u32DmxId已经没有意义。
 * param[in] dmx_id        DEMUX ID. CNcomment: DEMUX号。
 * param[out] free_count   Pointer to the number of available channels of a DEMUX.
 * CNcomment:指针类型，输出DEMUX空闲通道数目。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_free_play_chan_count(td_u32 dmx_id, td_u32 *free_count);

/*
 * brief Obtains the scrambled flag of the channel data.CNcomment:获取通道数据加扰标志。
 * You can query the scrambled PES data and ES data.CNcomment:支持PES级加扰和TS级加扰的查询。
 * param[in] play_chan        Channel handle.CNcomment:通道句柄。
 * param[out] scramble_flag   Pointer to the scrambled flag of the channel data (output).
 * For details, see the description of ::uapi_dmx_scrambled_flag.
 * CNcomment:指针类型，输出通道数据加扰标志。请参见::uapi_dmx_scrambled_flag。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_play_chan_scrambled_flag(td_handle play_chan, uapi_dmx_scrambled_flag *scramble_flag);

/*
 * brief Creates a data filter.CNcomment:创建一个数据过滤器。
 * The maximum depth of a filter is 16 bytes.
 * For details on how to set the attributes of a filter, see the description of ::uapi_dmx_filter_attr.
 * You can set a filter when creating it. If you do not want to filter data, you can set the filter depth to 0.
 * To modify the attributes of a filter, call uapi_dmx_set_filter_attr.
 * The attributes can be modified dynamically.
 * If a filter is used to filter the Section data, the valid byte is byte 1 and byte 4 to byte 18.
 * If a filter is used to filter the PES data, the valid byte is byte 4 and byte 7 to byte 21.
 * The filter can be used to filter the data of general-purpose channels only, including the Section channel,
 * ECM/EMM channel, and PES channel.
 * If a filter is allocated successfully, phFilter returns the handle of the created filter.
 * CNcomment:过滤器深度最大为16
 * 过滤器属性配置请参考::uapi_dmx_filter_attr
 * 创建过滤器时，同时实现对过滤器的设置；若不需要数据过滤，设置过滤器深度为0即可
 * 若需要修改过滤器属性，可调用uapi_dmx_set_filter_attr进行属性修改
 * 支持属性的动态修改
 * 过滤器用于过滤Section数据时，有效过滤字节为第1字节及第4字节～第18字节
 * 过滤器用于过滤PES数据时，有效过滤字节为第4字节及第7字节～第21字节
 * 过滤器只适用于通用通道的数据过滤，包括section通道、ECM/EMM通道和PES通道
 * 若分配成功，phFilter返回获取的过滤器Handle。
 * param[in] dmx_id DEMUX ID. CNcomment: DEMUX号。
 * param[in] filter_attr Pointer to the attributes of a filter (input).CNcomment:指针类型，输入过滤器属性。
 * param[out] filter Pointer to the handle of the created filter (output).CNcomment:指针类型，输出申请的过滤器Handle。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOFREE_FILTER There is no available filter.CNcomment:没有空闲filter。
 */
td_s32 uapi_dmx_create_filter(td_u32 dmx_id, const uapi_dmx_filter_attr *filter_attr, td_handle *filter);

/*
 * brief Destroys an existing data filter.CNcomment:销毁创建的数据过滤器。
 * If a filter is attached to a general-purpose channel, you can call this API to release the filter
 * when the channel is enabled or disabled.
 * If no filter is attached to a Section channel, the channel cannot receive data.
 * This restriction is not applicable to other channels.
 * CNcomment:若过滤器和通用通道绑定，允许在通道打开或者关闭状态下，调用本接口释放过滤器
 * 对于section通道当通道上没有任何过滤器绑定时，则不再接收数据，其他通道没有此限制。
 * param[in] filter  Filter handle.CNcomment:过滤器句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_destroy_filter(td_handle filter);

/*
 * brief Releases all the filters attached to a channel.CNcomment:释放绑定在某个通道上的所有过滤器。
 * You can call this API to release all filters attached to a channel when the channel is enabled
 * or disabled.CNcomment:允许在通道打开或者关闭状态下，调用本接口释放通道上绑定的所有过滤器。
 * param[in] play_chan  Channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is valid.CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_delete_all_filter(td_handle play_chan);

/*
 * brief Sets the filter criteria of a filter.CNcomment:设置过滤器的过滤条件。
 * The maximum filter depth u32FilterDepth is 16.
 * For details on how to set the attributes of a filter, see the description of ::uapi_dmx_filter_attr.
 * If a filter is used to filter the Section data, the valid byte is byte 1 and byte 4 to byte 18.
 * If a filter is used to filter the PES data, the valid byte is byte 4 and byte 7 to byte 21.
 * The attributes can be modified dynamically.
 * CNcomment:过滤器的深度属性u32FilterDepth最大为16
 * 过滤器属性配置请参考::uapi_dmx_filter_attr
 * 过滤器用于过滤Section数据时，有效过滤字节为第1字节及第4字节～第18字节
 * 过滤器用于过滤PES数据时，有效过滤字节为第4字节及第7字节～第21字节
 * 支持属性的动态修改。
 * param[in] filter        Filter handle.CNcomment:过滤器句柄。
 * param[in] filter_attr   Pointer to the attributes of a filter (input).CNcomment:指针类型，输入过滤器属性。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_ATTACHED_FILTER  The attributes cannot be set dynamically, because the filter is attached
 * to a channel.
 * CNcomment:过滤器绑定在通道上，不能动态设置。
 */
td_s32 uapi_dmx_set_filter_attr(td_handle filter, const uapi_dmx_filter_attr *filter_attr);

/*
 * brief Obtains the filter criteria of a filter.CNcomment:获取过滤器的过滤条件。
 * If you call the API before a filter is allocated, an error code is returned.
 * CNcomment:在过滤器未分配时调用该接口，返回错误。
 * param[in] filter         Filter handle.CNcomment:过滤器句柄。
 * param[out] filter_attr   Pointer to the attributes of a filter (output). For details,
 * see the description of ::uapi_dmx_filter_attr.CNcomment:指针类型，输出过滤器属性。请参见::uapi_dmx_filter_attr。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_filter_attr(td_handle filter, uapi_dmx_filter_attr *filter_attr);

/*
 * brief  Attaches filters to a specific channel.CNcomment:绑定过滤器到指定的通道。
 * One or more filters can be attached to a general-purpose channel. All filters are ORed.
 * That is, if the data meets the filter criteria of a filter, the data is transmitted to the DMA buffer.
 * Filters cannot be attached to the audio/video channel and post channel.
 * If a filter is used, it cannot be attached to one or more channels repeatedly.
 * If a filter and a channel do not belong to the same DEMUX, the filter cannot be detached from the channel.
 * A filter can be attached to a general-purpose channel when the channel is enabled or disabled.
 * CNcomment:一个通用通道可以绑定一个或者多个数据过滤器，所有过滤器之间的过滤关系是或。
 * 即只要满足其中任何一个过滤器的过滤条件，当前过滤的数据都将通过过滤而被送入DMA缓冲区
 * 不支持音视频通道和POST通道的过滤器绑定
 * 不能将一个过滤器重复绑定到一个或多个通道上
 * 过滤器与通道不属于同一路DEMUX时，不能进行绑定操作
 * 支持通用通道打开或者关闭状态下的过滤器绑定。
 * param[in] filter      Filter handle.CNcomment:过滤器句柄。
 * param[in] play_chan   Channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_ATTACHED_FILTER  The filter is attached.CNcomment:过滤器已经处于绑定状态。
 * retval ::SOC_ERR_DMX_NOT_SUPPORT   No filter can be attached to the channel.CNcomment:此类型通道不支持绑定过滤器。
 */
td_s32 uapi_dmx_attach_filter(td_handle filter, td_handle play_chan);

/*
 * brief Detaches a filter from a specific channel.CNcomment:将过滤器从指定通道上解绑定。
 * If no filter is attached to a channel, the error code TD_FAILURE is returned when you call this API.
 * If a filter and a channel do not belong to the same DEMUX, an error code is returned.
 * A filter can be detached from a general-purpose channel when the channel is enabled or disabled.
 * CNcomment:通道上没有绑定过滤器进行解绑定返回失败
 * 过滤器与通道不属于同一路DEMUX维护时，返回错误
 * 支持通用通道打开或者关闭状态下的过滤器解绑定。
 * param[in] filter     Filter handle.CNcomment:过滤器句柄。
 * param[in] play_chan  Channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NOATTACH_FILTER  No filter is attached to any channel.CNcomment:filter没有绑定在任何通道上。
 * retval ::SOC_ERR_DMX_UNMATCH_FILTER  No filter is attached to the channel.CNcomment:filter没有绑定在此通道上。
 */
td_s32 uapi_dmx_detach_filter(td_handle filter, td_handle play_chan);

/*
 * brief Obtains the handle of the channel to which a filter is attached.CNcomment:获取过滤器所绑定的通道句柄。
 * Each filter corresponds to a channel. If a filter is not attached to a channel, the error code
 * SOC_ERR_DMX_NOATTACH_FILTER is returned.
 * CNcomment:每个过滤器唯一对应一个通道。若过滤器没有绑定任何到通道上，则返回SOC_ERR_DMX_NOATTACH_FILTER错误码。
 * param[in] filter       Filter handle.CNcomment:过滤器句柄。
 * param[out] play_chan   Pointer to the handle of the channel to which a filter is attached (output).
 * CNcomment:指针类型，输出过滤器绑定的通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOATTACH_FILTER  No filter is attached to any channel.CNcomment:filter没有绑定在任何通道上。
 */
td_s32 uapi_dmx_get_filter_play_chan_handle(td_handle filter, td_handle *play_chan);

/*
 * brief Obtains the number of available filters of a DEMUX.CNcomment:获取DEMUX设备可用的空闲过滤器数量。
 * The number of unallocated filters is returned.
 * The filters that are allocated but not attached to channels are excluded.
 * CNcomment:返回当前未分配的过滤器数目，已分配但未绑定到通道上的过滤器不统计。
 * param[in] dmx_id        DEMUX ID. CNcomment: DEMUX号。
 * param[out]  free_count  Pointer to the number of allocated filters (output).
 * CNcomment:指针类型，输出当前未分配的过滤器数目。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_free_filter_count(td_u32 dmx_id, td_u32 *free_count);

/*
 * brief Obtains the handles of all channels that receive new data.CNcomment:获取有新数据到达的所有通道的句柄。
 * When you call this API, the parameter play_chan_num serves as the input parameter and is used to specify
 * the data length pointed by play_chan. play_chan_num indicates the number of channels to be queried.
 * The number of channels must be initialized, and the initial value cannot be 0.
 * It is recommended to set the number of channels to the total number. For details about the total number of channels.
 * After you call this API successfully, the parameter play_chan_num serves as the output parameter and is used to
 * specify the valid data length of play_chan array.
 * The block time is configurable (in ms). If timeout_ms is set to 0, it indicates that the block time is 0;
 * if timeout_ms is set to 0xFFFFFFFF, it indicates infinite wait.
 * If no data is received when the block time is exceeded, the error code SOC_ERR_DMX_TIMEOUT is returned.
 * If the wait time is 0, and no data is received in any channel, ::SOC_ERR_DMX_NOAVAILABLE_DATA is returned.
 * CNcomment:调用该接口时，play_chan_num作为输入参数，用于指定play_chan数组的长度，表示要查询的通道个数；
 * 通道个数必须初始化，且初始值必须为非0值
 * 建议将通道个数设置为通道的总个数
 * 当该接口调用成功时，play_chan_num作为输出参数，指定play_chan指向数组的有效长度
 * 阻塞时间可以设置，时间单位为毫秒，设置为0不等待，设置为0xffffffff一直等待。
 * 若超过阻塞时间，所有通道都没有数据到达，则返回等待超时错误
 * 如果等待时间为0，而且没有任何通道有数据则返回::SOC_ERR_DMX_NOAVAILABLE_DATA。
 * param[out] play_chan Pointer to the number of channels.
 * The number of channels depends on the value of  play_chan_num.
 * CNcomment:指针类型，指向通道句柄数组。数组长度由play_chan_num决定。
 * param[in] play_chan_num   Pointer type
 * Input: indicates the number of channel handles to which play_chan points.
 * Output: indicates the number of lower-layer channels that receive new data.
 * The maximum value cannot be greater than the input value.
 * CNcomment: 指针类型。注意:该参数同时作为输入和输出。
 * CNcomment: 输入：play_chan指向数组的长度。
 * CNcomment: 输出：底层有新数据通道的数目；最多不超过输入的数值。
 * param[in] timeout_ms      Wait timeout, in ms.CNcomment:等待超时时间，单位ms。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_DATA  No data is received in any channel.CNcomment:没有任何通道有数据到达。
 * retval ::SOC_ERR_DMX_TIMEOUT  The wait times out.CNcomment:等待超时。
 * retval ::SOC_ERR_DMX_NOT_OPEN_CHAN  No opened channels.CNcomment:没有可用的通道。
 */
td_s32 uapi_dmx_get_data_handle(td_handle play_chan[], td_u32 *play_chan_num, td_u32 timeout_ms);

/*
 * brief Obtains whether data is received in some channels.CNcomment:查询部分通道是否有数据到达。
 * This API is a supplementary interface of ::uapi_dmx_get_data_handle. You can call this API when you only want
 * to check whether data is received in some channels.
 * The handles of the channels to be queried are specified by watch_play_chan, and the number of channels to be queried
 * is specified by watch_num.
 * If watch_play_chan is NULL, all channels are queried. The value of watch_num cannot be 0.
 * The block time is configurable (in ms). If timeout_ms is set to 0, it indicates that the block time is 0;
 * if timeout_ms is set to 0xFFFFFFFF, it indicates infinite wait.
 * If no data is received when the block time is exceeded, the error code SOC_ERR_DMX_TIMEOUT is returned.
 * If the wait time is 0, and no data is received in any channel, ::SOC_ERR_DMX_NOAVAILABLE_DATA is returned.
 * CNcomment:用来作为::uapi_dmx_get_data_handle的补充，当应用中只关注部分通道的数据到达情况时使用此接口
 * 被监视通道的句柄由watch_play_chan指定，个数由watch_num指定
 * watch_play_chan为NULL,查询所有通道的数据到达情况，watch_num必须为非0值
 * 阻塞时间可以设置，时间单位为毫秒，设置为0不等待，设置为0xffffffff一直等待。
 * 若超过阻塞时间，所有通道都没有数据到达，则返回等待超时错误
 * 如果等待时间为0，而且没有任何通道有数据则返回::SOC_ERR_DMX_NOAVAILABLE_DATA。
 * param[in] watch_play_chan Pointer to the number of handles of the channels to be queried.
 * The number depends on the value of watch_num.
 * CNcomment:指针类型，指向被监视通道的句柄数组。数组长度有watch_num决定。
 * param[in] watch_num       Number of channels to be queried.CNcomment:监视通道的个数。
 * param[in] data_channel    Pointer to the number of handles of the channels that contain data.
 * The number depends on the value of chn_num.
 * CNcomment:指针类型，指向存在数据的通道的句柄数组。数组长度有chn_num决定。
 * param[out] chn_num        Pointer to the number of lower-layer channels that receive new data.
 * The maximum value cannot be greater than the input value.
 * CNcomment:指针类型。底层有新数据通道的数目；最多不超过被监视的通道的数值。
 * param[in] timeout_ms      Wait timeout, in ms.CNcomment:等待超时时间，单位ms。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR   The pointer is null.CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_DATA   No data is received in any channel.CNcomment:没有任何通道有数据到达。
 * retval ::SOC_ERR_DMX_TIMEOUT   The wait times out.CNcomment:等待超时。
 */
td_s32 uapi_dmx_select_data_handle(td_handle watch_play_chan[], td_u32 watch_num, td_handle *data_chan,
    td_u32 *chn_num, td_u32 timeout_ms);

/*
 * brief Obtains the received data packets from a specific channel.CNcomment:从指定通道中获取输出的数据包。
 * Before calling this API, you need to set the value of acquire_num to specify the maximum number of buffers that
 * can be queried. The number of buffers depends on the value of acquire_num.
 * The value of acquired_num is not greater than that of acquire_num.
 * For the Section channel, ECM channel, or EMM channel, each data packet contains a complete Section.
 * For the PES channel, each data packet may contain a complete PES. If the PES is too large,
 * it is divided into multiple PES packets to transfer.
 * The data_type field determines whether a transferred data packet is complete.
 * For the post channel, each data packet may contain one or more complete TS packets.
 * Each TS packet consists of 188 bytes.
 * For the audio/video channel, data cannot be obtained by calling this API.
 * The audio data and video data are transferred to the decoder through internal interfaces.
 * You cannot call this API repeatedly, but you can call this API once and release buffers for several times.
 * Note that you must release buffers in sequence, and the address and size of the buffer to be released must be
 * consistent with those obtained by calling uapi_dmx_acquire_buffer.
 * In addition, you can call uapi_dmx_acquire_buffer again only after all data packets are released.
 * Otherwise, the error code SOC_ERR_DMX_REACQUIRE_BUF is returned.
 * CNcomment:在调用本接口之前，给acquire_num赋值，指定允许查询的缓冲区信息最大数目。
 * 消息缓冲区数组的长度由acquire_num决定
 * 实际获取的缓冲区信息数目acquired_num数值不会超过acquire_num
 * 对于section通道和ECM/EMM通道，每个数据包包含一个完整的section
 * 对于PES通道，每个数据包尽量包含完整的pes，但是如果pes太大，可能要分多个pes包输出，
 * 输出的数据是否完整通过数据包结构的data_type字段指定
 * 对于POST类型的通道，每个数据包包含一个或多个完整的TS包，TS包长188字节
 * 对于音视频通道是不能通过此接口获取数据的，音视频数据会通过内部接口直接送给解码器进行解码
 * 不允许重复调用此接口，可以一次请求多次释放，但是释放必须按顺序，而且释放的地址和长度必须和请求的一致
 * 并且只有释放完所有的数据包才能再次请求，否则返回重复请求错误码。
 * param[in] play_chan         Channel handle.CNcomment:通道句柄。
 * param[in] acquire_num       Maximum number of obtained data packets.CNcomment:请求的数据包的最大个数。
 * param[out] acquired_num    Pointer to the actual number of obtained data packets.
 * CNcomment:指针类型，输出实际请求到的数据包个数。
 * param[out] buffer Pointer to the number of data packets. The number depends on the value of acquired_num.
 * CNcomment:指针类型，指向数据包信息数组，数组个数由acquired_num决定。
 * param[in] timeout_ms        Wait timeout, in ms.CNcomment:等待超时时间，单位为ms。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_DATA  There is no valid data in the channel.CNcomment:通道中没有有效数据。
 * retval ::SOC_ERR_DMX_TIMEOUT  The wait times out.CNcomment:等待超时。
 * retval ::SOC_ERR_DMX_REACQUIRE_BUF  The data packet has been obtained.CNcomment:重复请求数据包。
 */
td_s32 uapi_dmx_acquire_buffer(td_handle play_chan, td_u32 acquire_num, td_u32 *acquired_num, uapi_dmx_data *buffer,
                               td_u32 timeout_ms);

/*
 * brief Releases the buffers for storing data packets after data packets are processed.
 * CNcomment:处理完数据包的数据后，释放数据包占用的缓冲空间。
 * If you release buffers by calling this API, the buffers must be those obtained by calling
 * ::uapi_dmx_acquire_buffer, and the addresses and sizes of these buffers cannot be changed.
 * The number of released buffers can be less than the number of obtained buffers.
 * CNcomment:本接口释放的缓冲区一定是通过::uapi_dmx_acquire_buffer获取的缓冲区，缓冲区的地址和长度不能更改
 * 释放的缓冲区个数可以小于获取的缓冲区个数。
 * param[in] play_chan     Channel handl.CNcomment:通道句柄。
 * param[in] release_num   Number of released buffers.CNcomment:释放数据包个数。
 * param[in] buffer Pointer to the number of released buffers. The number depends on the value
 * of u32ReleaseNum.
 * CNcomment:指针类型，指向释放缓冲区信息数组，长度由u32ReleaseNum决定。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_release_buffer(td_handle play_chan, td_u32 release_num, const uapi_dmx_data *buffer);

/*
 * brief Obtains the received es data packets from a specific channel.CNcomment:从指定通道中获取输出的es数据包。
 * You can call this API to obtain video or audio es data.
 * It's allowed to call repeatedly and then release in the same order.
 * CNcomment:音视频通道通过此接口获取es数据.
 * 允许重复调用此接口获取有效数据，然后按相同顺序释放。
 * param[in] play_chan        Channel handle.CNcomment:通道句柄。
 * param[out] es_buffer       Pointer to the es data packets.CNcomment:指针类型，指向es数据包。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_DATA  There is no valid data in the channel。CNcomment:通道中没有有效数据。
 */
td_s32 uapi_dmx_acquire_es(td_handle play_chan, uapi_es_buf *es_buffer);

/*
 * brief Releases the es buffers after processed.CNcomment:处理完es数据包的数据后，释放数据包所在buffer。
 * If you release buffers by calling this API, the buffers must be those obtained by calling ::uapi_dmx_acquire_es,
 * and the addresses and sizes of these buffers cannot be changed.
 * CNcomment:本接口释放的缓冲区一定是通过::uapi_dmx_acquire_es获取的缓冲区，缓冲区的地址和长度不能更改.
 * param[in] play_chan     Channel handl.CNcomment:通道句柄。
 * param[in] es_buffer     Pointer to the es data packets.CNcomment:指针类型，指向es数据包。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_release_es(td_handle play_chan, const uapi_es_buf *es_buffer);

/*
 * brief Creates a record channel. CNcomment: 创建一个录制通道。
 * A demux can be set only one recording channe.
 * CNcomment: 一个DEMUX上只能创建一个录制通道。
 * param[in]  rec_attr  record attribute.   CNcomment: 录制属性。
 * param[out] rec_chan  record handle.      CNcomment: 录制句柄。
 * retval ::TD_SUCCESS  Success. CNcomment: 成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment: API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment: 模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment: 输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment: 指针参数为空。
 * retval ::SOC_ERR_DMX_NOFREE_CHAN  There is no available channel. CNcomment: 没有空闲的通道。
 * retval ::SOC_ERR_DMX_ALLOC_MEM_FAILED  memory allocate failure. CNcomment: 内存分配失败。
 * retval ::SOC_ERR_DMX_MMAP_FAILED  memory map failed. CNcomment: 内存映射失败。
 */
td_s32 uapi_dmx_create_rec_chan(const uapi_dmx_rec_attr *rec_attr, td_handle *rec_chan);

/*
 * brief Destroys an existing record channel. CNcomment: 销毁创建的录制通道。
 * param[in] rec_chan  record handle. CNcomment: 录制句柄。
 * retval ::TD_SUCCESS  Success. CNcomment: 成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment: API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment: 模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment: 输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment: 指针参数为空。
 */
td_s32 uapi_dmx_destroy_rec_chan(td_handle rec_chan);

/*
 * brief Attach demux handle and releated secure buffer to session manager.
 * CNcomment:将demux句柄及相应安全buffer绑定到 session manager。
 * The demux handle should be rec channel handle.
 * CNcomment:此处demux句柄为录制通道句柄。
 * param[in] rec_chan     RecChan handle.         CNcomment:录制通道句柄。
 * param[in] ssm_handle   Session manager handle. CNcomment:session manager句柄。
 * param[in] type         buffer attach type.     CNcomment:buffer绑定类型。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 */
td_s32 uapi_dmx_rec_chan_attach_ssm(td_handle rec_chan, td_handle ssm_handle, uapi_dmx_buffer_attach_type type);

/*
 * brief if the type of record were the UAPI_DMX_REC_TYPE_SELECT_PID, it would increase the recorded PID that we need.
 * CNcomment: 录制类型为UAPI_DMX_REC_TYPE_SELECT_PID时增加需要录制的PID。
 * param[in]  rec_chan  record handle.          CNcomment: 录制句柄。
 * param[in]  pid       pid value.              CNcomment: PID值。
 * param[out] pid_chan  pid channel handle指针. CNcomment: pid通道句柄指针。
 * retval ::TD_SUCCESS  Success. CNcomment: 成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment: API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment: 模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment: 输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment: 指针参数为空。
 * retval ::SOC_ERR_DMX_NOT_SUPPORT  This function is not supported. CNcomment: 不支持此功能。
 */
td_s32 uapi_dmx_add_rec_pid(td_handle rec_chan, td_u32 pid, td_handle *pid_chan);

/*
 * brief if the type of record were the UAPI_DMX_REC_TYPE_SELECT_PID, it would delete increase PID.
 * CNcomment: 录制类型为UAPI_DMX_REC_TYPE_SELECT_PID时删除已增加的PID。
 * param[in]  rec_chan    record handle.      CNcomment: 录制句柄。
 * param[in]  pid_chan    pid channel handle. CNcomment: pid通道句柄。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_del_rec_pid(td_handle rec_chan, td_handle pid_chan);

/*
 * brief if the type of record were the UAPI_DMX_REC_TYPE_SELECT_PID, it would delete all increase PID.
 * CNcomment: 录制类型为UAPI_DMX_REC_TYPE_SELECT_PID时删除所有已增加的PID。
 * param[in] rec_chan  record handle. CNcomment: 录制句柄。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_del_all_rec_pid(td_handle rec_chan);

/*
 * brief Starts a recording channel. CNcomment: 启动录制通道。
 * when the recording channel has been activated, it should use the interface to come back success.
 * CNcomment: 在录制通道已启动的状态下调用本接口返回成功。
 * param[in] rec_chan  record handle. CNcomment: 录制句柄。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_start_rec_chan(td_handle rec_chan);

/*
 * brief Stops a recording channel. CNcomment: 停止录制通道。
 * when the recording channel has been stopped, it should use the interface to come back success.
 * CNcomment: 在录制通道已停止的状态下调用本接口返回成功。
 * param[in] rec_chan  record handle. CNcomment: 录制句柄。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_stop_rec_chan(td_handle rec_chan);

/*
 * brief Obtains record data. CNcomment: 获取录制数据。
 * The obtained data must use the ::uapi_dmx_release_rec_data function to release.
 * CNcomment: 调用本接口获取到的数据必须使用::uapi_dmx_release_rec_data接口进行释放。
 * param[in]  rec_chan      record handle.          CNcomment: 录制句柄。
 * param[out] rec_data      record data.            CNcomment: 录制数据。
 * param[in]  timeout_ms    Wait timeout, in ms.    CNcomment: 等待超时时间，单位为毫秒。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_acquire_rec_data(td_handle rec_chan, uapi_dmx_rec_data *rec_data, td_u32 timeout_ms);

/*
 * brief Releases record data. CNcomment: 释放获取到的录制数据。
 * param[in] rec_chan   record handle.  CNcomment: 录制句柄。
 * param[in] rec_data   record data.    CNcomment: 录制数据。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_release_rec_data(td_handle rec_chan, const uapi_dmx_rec_data *rec_data);

/*
 * brief Obtains index data. CNcomment: 获取索引数据。
 * when indexing video or audio, it would use the interface to gain indexing data, or it will not support if you return.
 * CNcomment: 音频或视频索引时才能获取索引数据，否则返回不支持。
 * param[in]  rec_chan      record handle.          CNcomment: 录制句柄。
 * param[in]  acquire_num   Number of indexes requested.     CNcomment: 请求的索引数量
 * param[in]  acquired_num  Number of indexes received.      CNcomment: 收到的索引数量
 * param[out] rec_index     index data.             CNcomment: 索引数据。
 * param[in]  timeout_ms    Wait timeout, in ms.    CNcomment: 等待超时时间，单位为毫秒。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOT_START_REC_CHAN  CNcomment: 录制通道未启动。
 * retval ::SOC_ERR_DMX_NOT_SUPPORT  This function is not supported. CNcomment: 不支持此功能。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_DATA  no data. CNcomment: 无数据。
 * retval ::SOC_ERR_DMX_TIMEOUT  The wait times out. CNcomment:等待超时。
 */
td_s32 uapi_dmx_acquire_rec_index(td_handle rec_chan, td_u32 acquire_num, td_u32 *acquired_num,
    uapi_dmx_rec_index *rec_index, td_u32 timeout_ms);

/*
 * brief Obtains index and rec data with synchronous. CNcomment: 同步获取索引和录制数据 。
 * 1. when indexing video or audio, it would use the interface to gain indexing data and
 * record TS data with synchronous.
 * 2. when recording all ts without index, .it would use the interface to gain only record TS data,
 * as there is no index.
 * 3. Length of each block of record data is Alligned with 188 and 16 if it is not 0.
 * CNcomment:
 * 1. 音频或视频索引时，可以获取索引数据和与之对应的录制TS数据
 * 2.如果是allts 录制，则只可以获取录制的TS数据，此时无索引数据
 * 3. 获取上来的每一个数据块的长度如果不为0，都是188 与 16 对齐的。
 * param[in]  rec_chan         record handle.            CNcomment: 录制句柄。
 * param[out] rec_data_idx     index and record data.    CNcomment: 索引数据和录制TS数据。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_DMX_NOT_START_REC_CHAN  CNcomment: 录制通道未启动。
 * retval ::SOC_ERR_DMX_NOT_SUPPORT  This function is not supported. CNcomment: 不支持此功能。
 * retval ::SOC_ERR_DMX_NOAVAILABLE_DATA  no data. CNcomment: 无数据。
 */
td_s32 uapi_dmx_acquire_rec_data_and_index(td_handle rec_chan, uapi_dmx_rec_data_index *rec_data_idx);

/*
 * brief Releases record data. CNcomment: 释放获取到的索引数据和录制数据。
 * param[in] rec_chan       record handle.            CNcomment: 录制句柄。
 * param[in] rec_data_idx   record data and index.    CNcomment: 录制数据和索引数据。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 * retval ::SOC_ERR_MDX_REC_BUFNOTMATCH  The param is not mattched . CNcomment:参数不匹配，例如释放的地址或者长度非法。
 */
td_s32 uapi_dmx_release_rec_data_and_index(td_handle rec_chan, const uapi_dmx_rec_data_index *rec_data_idx);

/*
 * brief Obtains the status of a record buffer. CNcomment: 获取录制缓存的状态。
 * param[in]  rec_chan         record handle.          CNcomment: 录制句柄。
 * param[out] buffer_status    record buffer status.   CNcomment: 录制缓存的状态。
 * retval ::TD_SUCCESS  Success. CNcomment:成功。
 * retval ::TD_FAILURE  Calling this API fails. CNcomment:API系统调用失败。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized. CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_get_rec_buffer_status(td_handle rec_chan, uapi_dmx_rec_buf_status *buffer_status);

/*
 * brief register channel callback .CNcomment:注册通道回调。
 * param[in]  chan     Channel handle. CNcomment:通道Handle。
 * param[out] cb_desc  Pointer to the descriptor of a specified cb. For details, see the description of
 * uapi_dmx_cb_desc.
 * CNcomment:指针类型，输出指定通道 回调描述信息。请参见::uapi_dmx_cb_desc。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid.CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_register_callback(td_handle chan, const uapi_dmx_cb_desc *cb_desc);

/*
 * brief unregister channel callback.CNcomment:注销通道回调。
 * param[in] chan   Channel handle.CNcomment:通道句柄。
 * retval ::TD_SUCCESS Success.CNcomment:成功。
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化。
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法。
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空。
 */
td_s32 uapi_dmx_unregister_callback(td_handle chan);

/*
 * brief Set or get the extra attributes of a demux through the commands.CNcomment:通过命令设置或获取DMX附加属性
 * Diffrent CMD use diffrent param, for details see the description of uapi_dmx_invoke_type.
 * CNcomment:不同的命令使用的参数不同，具体信息请参考命令枚举的定义uapi_dmx_invoke_type
 * param[in] cmd_type   Command type.              CNcomment:命令类型。
 * param[in] cmd_para   Pointer to command param.  CNcomment:命令参数
 * retval ::TD_SUCCESS Success.CNcomment:成功
 * retval ::TD_FAILURE  Calling this API fails.CNcomment:API系统调用失败
 * retval ::SOC_ERR_DMX_NOT_INIT  The DEMUX module is not initialized.CNcomment:模块没有初始化
 * retval ::SOC_ERR_DMX_INVALID_PARA  The input parameter is invalid. CNcomment:输入参数非法
 * retval ::SOC_ERR_DMX_NULL_PTR  The pointer is null. CNcomment:指针参数为空
 */
td_s32 uapi_dmx_invoke(uapi_dmx_invoke_type cmd_type, const td_void *cmd_para);

#ifdef __cplusplus
#if __cplusplus
}
#endif
#endif

#endif /* __UAPI_DEMUX_H__ */