aboutsummaryrefslogtreecommitdiff
path: root/include/linux/vcodec/vdec_drv_if_public.h
blob: 28640020a914af819cae193d4adbc589f5a4e649 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
/**
 * @file
 *   vdec_drv_if_public.h
 *
 * @par Project:
 *   Video
 *
 * @par Description:
 *   Video Decoder Driver Interface for external use
 *
 * @par Author:
 *   Jackal Chen (mtk02532)
 *
 * @par $Revision: #1 $
 * @par $Modtime:$
 * @par $Log:$
 *
 */

#ifndef _VDEC_DRV_IF_PUBLIC_H_
#define _VDEC_DRV_IF_PUBLIC_H_

#ifdef __cplusplus
extern "C" {
#endif

#include "val_types_public.h"


/**
 * @par Enumeration
 *   VDEC_DRV_FBSTSTUS
 * @par Description
 *   This is the item for frame buffer status
 */
typedef enum _VDEC_DRV_FBSTSTUS
{
    VDEC_DRV_FBSTSTUS_NORMAL      = 0,          ///< normal type
    VDEC_DRV_FBSTSTUS_REPEAT_LAST = (1 << 0),   ///< repeat last frame
    VDEC_DRV_FBSTSTUS_NOT_DISPLAY = (1 << 1),   ///< not displayed
    VDEC_DRV_FBSTSTUS_NOT_USED    = (1 << 2),   ///< not used
}
VDEC_DRV_FBSTSTUS;


/**
 * @par Enumeration
 *  VDEC_DRV_VIDEO_FORMAT_T
 * @par Description
 *  video_format of VDecDrvCreate()
 */
typedef enum _VDEC_DRV_VIDEO_FORMAT_T
{
    VDEC_DRV_VIDEO_FORMAT_UNKNOWN_VIDEO_FORMAT  = 0,            ///< Unknown video format
    VDEC_DRV_VIDEO_FORMAT_DIVX311               = (1 << 0),     ///< Divix 3.11
    VDEC_DRV_VIDEO_FORMAT_DIVX4                 = (1 << 1),     ///< Divix 4
    VDEC_DRV_VIDEO_FORMAT_DIVX5                 = (1 << 2),     ///< Divix 5
    VDEC_DRV_VIDEO_FORMAT_XVID                  = (1 << 3),     ///< Xvid
    VDEC_DRV_VIDEO_FORMAT_MPEG1                 = (1 << 4),     ///< MPEG-1
    VDEC_DRV_VIDEO_FORMAT_MPEG2                 = (1 << 5),     ///< MPEG-2
    VDEC_DRV_VIDEO_FORMAT_MPEG4                 = (1 << 6),     ///< MPEG-4
    VDEC_DRV_VIDEO_FORMAT_H263                  = (1 << 7),     ///< H263
    VDEC_DRV_VIDEO_FORMAT_H264                  = (1 << 8),     ///< H264
    VDEC_DRV_VIDEO_FORMAT_H265                  = (1 << 9),     ///< H265
    VDEC_DRV_VIDEO_FORMAT_WMV7                  = (1 << 10),    ///< WMV7
    VDEC_DRV_VIDEO_FORMAT_WMV8                  = (1 << 11),    ///< WMV8
    VDEC_DRV_VIDEO_FORMAT_WMV9                  = (1 << 12),    ///< WMV9
    VDEC_DRV_VIDEO_FORMAT_VC1                   = (1 << 13),    ///< VC1
    VDEC_DRV_VIDEO_FORMAT_REALVIDEO8            = (1 << 14),    ///< RV8
    VDEC_DRV_VIDEO_FORMAT_REALVIDEO9            = (1 << 15),    ///< RV9
    VDEC_DRV_VIDEO_FORMAT_VP6                   = (1 << 16),    ///< VP6
    VDEC_DRV_VIDEO_FORMAT_VP7                   = (1 << 17),    ///< VP7
    VDEC_DRV_VIDEO_FORMAT_VP8                   = (1 << 18),    ///< VP8
    VDEC_DRV_VIDEO_FORMAT_VP8_WEBP_PICTURE_MODE = (1 << 19),    ///< VP8 WEBP PICTURE MODE
    VDEC_DRV_VIDEO_FORMAT_VP8_WEBP_MB_ROW_MODE  = (1 << 20),    ///< VP8 WEBP ROW MODE
    VDEC_DRV_VIDEO_FORMAT_VP9                   = (1 << 21),    ///< VP9
    VDEC_DRV_VIDEO_FORMAT_VP9_WEBP_PICTURE_MODE = (1 << 22),    ///< VP9 WEBP PICTURE MODE
    VDEC_DRV_VIDEO_FORMAT_VP9_WEBP_MB_ROW_MODE  = (1 << 23),    ///< VP9 WEBP ROW MODE
    VDEC_DRV_VIDEO_FORMAT_AVS                   = (1 << 24),    ///< AVS
    VDEC_DRV_VIDEO_FORMAT_MJPEG                 = (1 << 25),    ///< Motion JPEG
    VDEC_DRV_VIDEO_FORMAT_S263                  = (1 << 26),    ///< Sorenson Spark
    VDEC_DRV_VIDEO_FORMAT_H264HP                = (1 << 27),
    VDEC_DRV_VIDEO_FORMAT_H264SEC               = (1 << 28)
} VDEC_DRV_VIDEO_FORMAT_T;


/**
 * @par Enumeration
 *  VDEC_DRV_H265_VIDEO_PROFILE_T
 * @par Description
 *  video profile for H.265
 */
typedef enum _VDEC_DRV_H265_VIDEO_PROFILE_T
{
    VDEC_DRV_H265_VIDEO_PROFILE_UNKNOWN         = 0,            ///< Unknown video profile
    VDEC_DRV_H265_VIDEO_PROFILE_H265_MAIN       = (1 << 0),      ///< H265 main profile
    VDEC_DRV_H265_VIDEO_PROFILE_H265_MAIN_10       = (1 << 1),      ///< H265 main 10 profile
    VDEC_DRV_H265_VIDEO_PROFILE_H265_STILL_IMAGE       = (1 << 2)      ///< H265 still image profile
} VDEC_DRV_H265_VIDEO_PROFILE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_H264_VIDEO_PROFILE_T
 * @par Description
 *  video profile for H.264
 */
typedef enum _VDEC_DRV_H264_VIDEO_PROFILE_T
{
    VDEC_DRV_H264_VIDEO_PROFILE_UNKNOWN                   = 0,          ///< Unknown video profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_BASELINE             = (1 << 0),   ///< H264 baseline profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_CONSTRAINED_BASELINE = (1 << 1),   ///< H264 constrained baseline profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_MAIN                 = (1 << 2),   ///< H264 main profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_EXTENDED             = (1 << 3),   ///< H264 extended profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH                 = (1 << 4),   ///< H264 high profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH_10              = (1 << 5),   ///< H264 high 10 profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH422              = (1 << 6),   ///< H264 high 422 profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH444              = (1 << 7),   ///< H264 high 444 profile
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH_10_INTRA        = (1 << 8),   ///< H264 high 10 intra profile in Amendment 2
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH422_INTRA        = (1 << 9),   ///< H264 high 422 intra profile in Amendment 2
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH444_INTRA        = (1 << 10),  ///< H264 high 444 intra profile in Amendment 2
    VDEC_DRV_H264_VIDEO_PROFILE_H264_CAVLC444_INTRA       = (1 << 11),  ///< H264 CAVLC 444 intra profile in Amendment 2
    VDEC_DRV_H264_VIDEO_PROFILE_H264_HIGH444_PREDICTIVE   = (1 << 12),  ///< H264 high 444 predictive profile in Amendment 2
    VDEC_DRV_H264_VIDEO_PROFILE_H264_SCALABLE_BASELINE    = (1 << 13),  ///< H264 scalable baseline profile in Amendment 3
    VDEC_DRV_H264_VIDEO_PROFILE_H264_SCALABLE_HIGH        = (1 << 14),  ///< H264 scalable high profile in Amendment 3
    VDEC_DRV_H264_VIDEO_PROFILE_H264_SCALABLE_HIGH_INTRA  = (1 << 15),  ///< H264 scalable high intra profile in Amendment 3
    VDEC_DRV_H264_VIDEO_PROFILE_H264_MULTIVIEW_HIGH       = (1 << 16)   ///< Corrigendum 1 (2009)
} VDEC_DRV_H264_VIDEO_PROFILE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_MPEG_VIDEO_PROFILE_T
 * @par Description
 *  video profile for H263, MPEG2, MPEG4
 */
typedef enum _VDEC_DRV_MPEG_VIDEO_PROFILE_T
{
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_0                = (1 << 0),   ///< H263 Profile 0
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_1                = (1 << 1),   ///< H263 Profile 1
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_2                = (1 << 2),   ///< H263 Profile 2
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_3                = (1 << 3),   ///< H263 Profile 3
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_4                = (1 << 4),   ///< H263 Profile 4
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_5                = (1 << 5),   ///< H263 Profile 5
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_6                = (1 << 6),   ///< H263 Profile 6
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_7                = (1 << 7),   ///< H263 Profile 7
    VDEC_DRV_MPEG_VIDEO_PROFILE_H263_8                = (1 << 8),   ///< H263 Profile 8
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG2_SIMPLE          = (1 << 9),   ///< MPEG2 Simple Profile
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG2_MAIN            = (1 << 10),  ///< MPEG2 Main Profile
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG2_SNR             = (1 << 11),  ///< MPEG2 SNR Profile
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG2_SPATIAL         = (1 << 12),  ///< MPEG2 Spatial Profile
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG2_HIGH            = (1 << 13),  ///< MPEG2 High Profile
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG4_SIMPLE          = (1 << 14),  ///< MPEG4 Simple Profile
    VDEC_DRV_MPEG_VIDEO_PROFILE_MPEG4_ADVANCED_SIMPLE = (1 << 15)   ///< MPEG4 Advanced Simple Profile
} VDEC_DRV_MPEG_VIDEO_PROFILE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_MS_VIDEO_PROFILE_T
 * @par Description
 *  video profile for VC1, WMV9
 */
typedef enum _VDEC_DRV_MS_VIDEO_PROFILE_T
{
    VDEC_DRV_MS_VIDEO_PROFILE_VC1_SIMPLE   = (1 << 0),  ///< VC-1 Simple Profile
    VDEC_DRV_MS_VIDEO_PROFILE_VC1_MAIN     = (1 << 1),  ///< VC-1 Main Profile
    VDEC_DRV_MS_VIDEO_PROFILE_VC1_ADVANCED = (1 << 2),  ///< VC-1 Advanced Profile
    VDEC_DRV_MS_VIDEO_PROFILE_WMV9_SIMPLE  = (1 << 3),  ///< WMV9 Simple Profile
    VDEC_DRV_MS_VIDEO_PROFILE_WMV9_MAIN    = (1 << 4),  ///< WMV9 Main Profile
    VDEC_DRV_MS_VIDEO_PROFILE_WMV9_COMPLEX = (1 << 5)   ///< WMV9 Complex Profile
} VDEC_DRV_MS_VIDEO_PROFILE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_VIDEO_LEVEL_T
 * @par Description
 *  video level
 */
typedef enum _VDEC_DRV_VIDEO_LEVEL_T
{
    VDEC_DRV_VIDEO_LEVEL_UNKNOWN = 0,           ///< Unknown level
    VDEC_DRV_VIDEO_LEVEL_0,                     ///< Specified by VC1
    VDEC_DRV_VIDEO_LEVEL_1,                     ///< Specified by H264, VC1, MPEG4, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_1,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_1b,                    ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_1_1,                   ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_1_2,                   ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_1_3,                   ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_2,                     ///< Specified by H264, VC1, MPEG4, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_2,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_2_1,                   ///< Specified by H264, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_2_1,  ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_2_2,                   ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_3,                     ///< Specified by H264, VC1, MPEG4, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_3,    ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_3_1,                   ///< Specified by H264, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_3_1,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_3_2,                   ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_4,                     ///< Specified by H264, VC1, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_4,     ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_4_1,                   ///< Specified by H264, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_4_1,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_4_2,                   ///< Specified by H264
    VDEC_DRV_VIDEO_LEVEL_5,                     ///< Specified by H264, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_5,     ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_5_1,                   ///< Specified by H264, HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_5_1,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_5_2,                    ///< Specified by HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_5_2,    ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_6,                        ///< Specified by HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_6,     ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_6_1,                    ///< Specified by HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_6_1,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_6_2,                    ///< Specified by HEVC
    VDEC_DRV_VIDEO_HIGH_TIER_LEVEL_6_2,   ///< Specified by HEVC
    VDEC_DRV_VIDEO_LEVEL_LOW,                   ///< Specified by MPEG2, VC1
    VDEC_DRV_VIDEO_LEVEL_MEDIUM,                ///< Specified by MPEG2, VC1
    VDEC_DRV_VIDEO_LEVEL_HIGH1440,              ///< Specified by MPEG2
    VDEC_DRV_VIDEO_LEVEL_HIGH                  ///< Specified by MPEG2, VC1

} VDEC_DRV_VIDEO_LEVEL_T;


/**
 * @par Enumeration
 *  VDEC_DRV_RESOLUTION_T
 * @par Description
 *  video resolution support
 */
typedef enum _VDEC_DRV_RESOLUTION_T
{
    VDEC_DRV_RESOLUTION_UNKNOWN = 0,    ///< Unknown resolution
    VDEC_DRV_RESOLUTION_SUPPORT_QCIF,   ///< QCIF
    VDEC_DRV_RESOLUTION_SUPPORT_QVGA,   ///< QVGA
    VDEC_DRV_RESOLUTION_SUPPORT_CIF,    ///< CIF
    VDEC_DRV_RESOLUTION_SUPPORT_480I,   ///< 720x480 interlace
    VDEC_DRV_RESOLUTION_SUPPORT_480P,   ///< 720x480 progressive
    VDEC_DRV_RESOLUTION_SUPPORT_576I,   ///< 720x576 interlace
    VDEC_DRV_RESOLUTION_SUPPORT_576P,   ///< 720x576 progressive
    VDEC_DRV_RESOLUTION_SUPPORT_720P,   ///< 1280x720 progressive
    VDEC_DRV_RESOLUTION_SUPPORT_1080I,  ///< 1920x1080 interlace
    VDEC_DRV_RESOLUTION_SUPPORT_1080P,   ///< 1920x1080 progressive
    VDEC_DRV_RESOLUTION_SUPPORT_2160P   ///< 4096x2160 progressive
} VDEC_DRV_RESOLUTION_T;


/**
 * @par Enumeration
 *  VDEC_DRV_QUERY_TYPE_T
 * @par Description
 *  video driver used to query different info
 */
typedef enum _VDEC_DRV_QUERY_TYPE_T
{
    VDEC_DRV_QUERY_TYPE_FBTYPE,             ///< Query VDEC_DRV_QUERY_TYPE_FBTYPE
    VDEC_DRV_QUERY_TYPE_VIDEO_FORMAT,       ///< Query VDEC_DRV_QUERY_TYPE_VIDEO_FORMAT
    VDEC_DRV_QUERY_TYPE_PROPERTY,           ///< Query VDEC_DRV_PROPERTY_T
    VDEC_DRV_QUERY_TYPE_CHIP_NAME,          ///< Query VDEC_DRV_QUERY_TYPE_CHIP_NAME
    VDEC_DRV_QUERY_TYPE_BUFFER_CONTROL,     ///< Query VDEC_DRV_QUERY_TYPE_BUFFER_CONTROL
    VDEC_DRV_QUERY_TYPE_FEATURE_SUPPORTED,   ///< Query VDEC_DRV_QUERY_TYPE_FEATURE_SUPPORTED
    VDEC_DRV_QUERY_TYPE_CPUCORE_FREQUENCY,   ///< Query VDEC_DRV_QUERY_TYPE_CPUCORE_FREQUENCY
} VDEC_DRV_QUERY_TYPE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_QUERY_TYPE_T
 * @par Description
 *  video driver used to queue multiple input buffers
 */
typedef enum _VDEC_DRV_FEATURE_TYPE_T
{
    VDEC_DRV_FEATURE_TYPE_NONE                = 0,        ///< Empty
    VDEC_DRV_FEATURE_TYPE_QUEUE_INPUT_BUFFER  = (1 << 0), ///< Driver will queue multiple input buffers
} VDEC_DRV_FEATURE_TYPE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_GET_TYPE_T
 * @par Description
 *  video driver used to get/query different info
 */
typedef enum _VDEC_DRV_GET_TYPE_T
{
    VDEC_DRV_GET_TYPE_QUERY_REF_POOL_SIZE,          ///< how many buffer size of the reference pool needs in driver
    VDEC_DRV_GET_TYPE_QUERY_DISP_POOL_SIZE,         ///< how many buffer size of the display pool needs in driver
    VDEC_DRV_GET_TYPE_DISP_FRAME_BUFFER,            ///< return a P_VDEC_DRV_FRAMEBUF_T address (especially in display order != decode order)
    VDEC_DRV_GET_TYPE_FREE_FRAME_BUFFER,            ///< return a frame didn't be a reference more (when buffer_mode = REF_IS_DISP_EXT, REF_INT_DISP_EXT or REF_INT_POOL_DISP_EXT)
    VDEC_DRV_GET_TYPE_GET_PICTURE_INFO,             ///< return a pointer address point to P_VDEC_DRV_PICINFO_T
    VDEC_DRV_GET_TYPE_GET_STATISTIC_INFO,           ///< return statistic information.
    VDEC_DRV_GET_TYPE_GET_FRAME_MODE,               ///< return frame mode parameter.
    VDEC_DRV_GET_TYPE_GET_FRAME_CROP_INFO,          ///< return frame crop information.
    VDEC_DRV_GET_TYPE_QUERY_REORDER_ABILITY,        ///< query if driver can re-order the decode order to display order
    VDEC_DRV_GET_TYPE_QUERY_DOWNSIZE_ABILITY,       ///< query if driver can downsize decoded frame
    VDEC_DRV_GET_TYPE_QUERY_RESIZE_ABILITY,         ///< query if driver can resize decoded frame
    VDEC_DRV_GET_TYPE_QUERY_DEBLOCK_ABILITY,        ///< query if driver can do deblocking
    VDEC_DRV_GET_TYPE_QUERY_DEINTERLACE_ABILITY,    ///< query if driver can do deinterlace
    VDEC_DRV_GET_TYPE_QUERY_DROPFRAME_ABILITY,      ///< query if driver can drop frame
    VDEC_DRV_GET_TYPE_GET_DECODE_STATUS_INFO,       ///< query if driver finish decode one frame but no output (main profile with B frame case.)
    VDEC_DRV_GET_TYPE_GET_PIXEL_FORMAT,             ///< query the driver output pixel format
    VDEC_DRV_GET_TYPE_GET_CPU_LOADING_INFO,         ///< query the cpu loading info from kernel driver
    VDEC_DRV_GET_TYPE_GET_HW_CRC,                   ///< query the hw CRC
    VDEC_DRV_GET_TYPE_GET_CODEC_TIDS,               ///< query the thread ids from the codec lib
    VDEC_DRV_GET_TYPE_GET_FRAME_INTERVAL,           ///< query frame interval from the codec lib
    VDEC_DRV_GET_TYPE_FREE_INPUT_BUFFER,            ///< free input buffer
    VDEC_DRV_GET_TYPE_QUERY_VIDEO_INTERLACING,      ///< query video interlace information
    VDEC_DRV_GET_TYPE_QUERY_VIDEO_DPB_SIZE          ///< query video DPB size
} VDEC_DRV_GET_TYPE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_PIXEL_FORMAT_T
 * @par Description
 *  pixel format
 */
typedef enum _VDEC_DRV_PIXEL_FORMAT_T
{
    VDEC_DRV_PIXEL_FORMAT_NONE =   0,               ///< None
    VDEC_DRV_PIXEL_FORMAT_YUV_420_PLANER,           ///< YUV 420 planer
    VDEC_DRV_PIXEL_FORMAT_YUV_420_PLANER_MTK,       ///< YUV 420 planer MTK mode
    VDEC_DRV_PIXEL_FORMAT_YUV_420_PLANER_UFO,       ///< YUV 420 planer MTK UFO mode
    VDEC_DRV_PIXEL_FORMAT_YUV_YV12                  ///< YUV YV12
} VDEC_DRV_PIXEL_FORMAT_T;


/**
 * @par Enumeration
 *  VDEC_DRV_DECODER_TYPE_T
 * @par Description
 *  decoder type
 */
typedef enum _VDEC_DRV_DECODER_TYPE_T
{
    VDEC_DRV_DECODER_MTK_HARDWARE = 0,              ///< MTK software
    VDEC_DRV_DECODER_MTK_SOFTWARE,                  ///< MTK hardware
    VDEC_DRV_DECODER_GOOGLE_SOFTWARE                ///< google software (default)
}   VDEC_DRV_DECODER_TYPE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_SET_TYPE_T
 * @par Description
 *  video driver used to set different info
 */
typedef enum _VDEC_DRV_SET_TYPE_T
{
    VDEC_DRV_SET_TYPE_USE_EXT_TIMESTAMP,            ///< =1, use timestamp in sVDEC_DRV_FRAMEBUF_T for the picture
    VDEC_DRV_SET_TYPE_SET_BUFFER_MODE,              ///< value is one of VDEC_DRV_BUFFER_MODE
    VDEC_DRV_SET_TYPE_SET_FRAME_BUFFER_TYPE,        ///< one of VDEC_DRV_FBTYPE, if output type is the same as decode type, buffer mode can be REF_IS_DISP
    VDEC_DRV_SET_TYPE_FREE_FRAME_BFFER,             ///< release buffer if DISP BUFFER is allocated from driver
    VDEC_DRV_SET_TYPE_SET_REF_EXT_POOL_ADDR,        ///< if use REF_EXT_POOL in SET_BUFFER_MODE
    VDEC_DRV_SET_TYPE_SET_DISP_EXT_POOL_ADDR,       ///< if use DISP_EXT_POOL in SET_BUFFER_MODE
    VDEC_DRV_SET_TYPE_SET_DECODE_MODE,              ///< set if drop frame
    VDEC_DRV_SET_TYPE_SET_POST_PROC,                ///< buffer mode cannot set to REF_IS_DISP when using post-processing
    VDEC_DRV_SET_TYPE_SET_STATISTIC_ON,             ///< enable statistic function.
    VDEC_DRV_SET_TYPE_SET_STATISTIC_OFF,            ///< disable statistic function.
    VDEC_DRV_SET_TYPE_SET_FRAME_MODE,               ///< set frame mode
    VDEC_DRV_SET_TYPE_SET_BUF_STATUS_FOR_SPEEDY,    ///< set buffer status for speedy mode
    VDEC_DRV_SET_TYPE_SET_LAST_DISPLAY_TIME,        ///< set the last display time
    VDEC_DRV_SET_TYPE_SET_CURRENT_PLAY_TIME,        ///< set the current play time
    VDEC_DRV_SET_TYPE_SET_CONCEAL_LEVEL,            ///< error conceal level for decoder
    VDEC_DRV_SET_TYPE_SET_OMX_TIDS,                 ///< set omx thread ids
    VDEC_DRV_SET_TYPE_SET_SWITCH_TVOUT,             ///< set ot switch to TV OUT
    VDEC_DRV_SET_TYPE_SET_CODEC_COLOR_FORAMT,       ///< set codec color format
    VDEC_DRV_SET_TYPE_SET_CODEC_YUV_STRIDE,         ///< set codec yuv stride
    VDEC_DRV_SET_TYPE_SET_FRAMESIZE,                ///< set frame size from caller for MPEG4 decoder
    VDEC_DRV_SET_TYPE_SET_FIXEDMAXOUTPUTBUFFER,     ///< use the max suppoerted size as output buffer size. for smooth
    VDEC_DRV_SET_TYPE_SET_UFO_DECODE,
} VDEC_DRV_SET_TYPE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_DECODE_MODE_T
 * @par Description
 *  video driver decode mode
 */
typedef enum _VDEC_DRV_DECODE_MODE_T
{
    VDEC_DRV_DECODE_MODE_UNKNOWN = 0,               ///< Unknown
    VDEC_DRV_DECODE_MODE_NORMAL,                    ///< decode all frames (no drop)
    VDEC_DRV_DECODE_MODE_I_ONLY,                    ///< skip P and B frame
    VDEC_DRV_DECODE_MODE_B_SKIP,                    ///< skip B frame
    VDEC_DRV_DECODE_MODE_DROPFRAME,                 ///< display param1 frames & drop param2 frames
    VDEC_DRV_DECODE_MODE_NO_REORDER,                ///< output display ASAP without reroder
    VDEC_DRV_DECODE_MODE_THUMBNAIL,                 ///< thumbnail mode
    VDEC_DRV_DECODE_MODE_SKIP_REFERENCE_CHECK,      ///< skip reference check mode - force decode and display from first frame
    VDEC_DRV_DECODE_MODE_LOW_LATENCY_DECODE,        ///< decode immediately no check. (parser should make sure the completed frame)
} VDEC_DRV_DECODE_MODE_T;


/**
 * @par Enumeration
 *  VDEC_DRV_MRESULT_T
 * @par Description
 *  Driver return type
 */
typedef enum __VDEC_DRV_MRESULT_T
{
    VDEC_DRV_MRESULT_OK = 0,                        ///< OK
    VDEC_DRV_MRESULT_FAIL,                          ///< Fail
    VDEC_DRV_MRESULT_FATAL,                         ///< Fatal error to stop.
    VDEC_DRV_MRESULT_RESOLUTION_CHANGED,            ///< Represent resoluion changed
    VDEC_DRV_MRESULT_NEED_MORE_OUTPUT_BUFFER,       ///< Represent need more output buffer
    VDEC_DRV_MRESULT_MAX = 0x0FFFFFFF               ///< Max Value
} VDEC_DRV_MRESULT_T;


/**
 * @par Structure
 *  VDEC_DRV_RINGBUF_T
 * @par Description
 *  Ring Buffer Structure
 *  - Store buffer base address
 *  - Store read/write pointer address
 */
typedef struct __VDEC_DRV_RINGBUF_T
{
    VAL_MEM_ADDR_T  rBase;                      ///< [IN]     Base address of ring buffer
    VAL_ULONG_T     u4Read;                     ///< [IN/OUT] Virtual address of read pointer
    VAL_ULONG_T     u4Write;                    ///< [IN]     Virtual address of write pointer
    VAL_UINT32_T    u4Timestamp;                ///< [IN/OUT] store timestamp
    VAL_UINT32_T    rSecMemHandle;              ///< [IN/OUT] security memory handle    // MTK_SEC_VIDEO_PATH_SUPPORT
} VDEC_DRV_RINGBUF_T;

/**
 * @par Structure
 *  P_VDEC_DRV_RINGBUF_T
 * @par Description
 *  Pointer of VDEC_DRV_RINGBUF_T
 */
typedef VDEC_DRV_RINGBUF_T *P_VDEC_DRV_RINGBUF_T;


/**
 * @par Structure
 *  VDEC_DRV_FRAMEBUF_T
 * @par Description
 *  Frame buffer information
 */
typedef struct __VDEC_DRV_FRAMEBUF_T
{
    VAL_MEM_ADDR_T  rBaseAddr;                  ///< [IN/OUT] Base address
    VAL_MEM_ADDR_T  rPostProcAddr;              ///< [IN/OUT] Post process address
    VAL_UINT32_T    u4BufWidth;                 ///< [IN/OUT] Buffer width
    VAL_UINT32_T    u4BufHeight;                ///< [IN/OUT] Buffer height
    VAL_UINT32_T    u4DispWidth;                ///< [OUT]    Display width
    VAL_UINT32_T    u4DispHeight;               ///< [OUT]    Display width
    VAL_UINT32_T    u4DispPitch;                ///< [OUT]    Display pitch
    VAL_UINT32_T    u4Timestamp;                ///< [IN/OUT] Timestamp for last decode picture
    VAL_UINT32_T    u4AspectRatioW;             ///< [OUT]    The horizontal size of the sample aspect ratio.
    VAL_UINT32_T    u4AspectRatioH;             ///< [OUT]    The vertical size of the sample aspect ratio.
    VAL_UINT32_T    u4FrameBufferType;          ///< [OUT]    One of VDEC_DRV_FBTYPE
    VAL_UINT32_T    u4PictureStructure;         ///< [OUT]    One of VDEC_DRV_PIC_STRUCT
    VAL_UINT32_T    u4FrameBufferStatus;        ///< [OUT]    One of VDEC_DRV_FBSTSTUS
    VAL_UINT32_T    u4IsUFOEncoded;             ///< [OUT]    FB Is UFO Encoded
    VAL_UINT32_T    u4Reserved1;                ///< [IN/OUT] Reserved
    VAL_UINT32_T    u4Reserved2;                ///< [IN/OUT] Reserved
    VAL_UINT32_T    u4Reserved3;                ///< [IN/OUT] Reserved
    VAL_UINT32_T    rSecMemHandle;              ///< [IN/OUT] security memory handle    // MTK_SEC_VIDEO_PATH_SUPPORT
    VAL_UINT32_T    u4ReeVA;                    ///< [IN/OUT] Ree Va    // MTK_SEC_VIDEO_PATH_SUPPORT
    VAL_UINT32_T    rFrameBufVaShareHandle;     ///< [IN/OUT] share handle of rBaseAddr.u4VA (for UT only)  // MTK_SEC_VIDEO_PATH_SUPPORT
} VDEC_DRV_FRAMEBUF_T;

/**
 * @par Structure
 *  P_VDEC_DRV_FRAMEBUF_T
 * @par Description
 *  Pointer of VDEC_DRV_FRAMEBUF_T
 */
typedef VDEC_DRV_FRAMEBUF_T *P_VDEC_DRV_FRAMEBUF_T;


/**
 * @par Structure
 *  VDEC_DRV_CROPINFO_T
 * @par Description
 *  Frame cropping information
 */
typedef struct __VDEC_DRV_CROPINFO_T
{
    VAL_UINT32_T u4CropLeft;        ///< Frame cropping left index
    VAL_UINT32_T u4CropRight;      ///< Frame cropping right index
    VAL_UINT32_T u4CropTop;           ///< Frame cropping top index
    VAL_UINT32_T u4CropBottom;      ///< Frame cropping bottom index
} VDEC_DRV_CROPINFO_T;


/**
 * @par Structure
 *  P_VDEC_DRV_CROPINFO_T
 * @par Description
 *  Pointer of VDEC_DRV_CROPINFO_T
 */
typedef VDEC_DRV_CROPINFO_T *P_VDEC_DRV_CROPINFO_T;

/**
 * @par Structure
 *  VDEC_DRV_PICINFO_T
 * @par Description
 *  Picture information
 */
typedef struct __VDEC_DRV_PICINFO_T
{
    VAL_UINT32_T    u4Width;                    ///< [OUT] Frame width
    VAL_UINT32_T    u4Height;                   ///< [OUT] Frame height
    VAL_UINT32_T    u4RealWidth;                ///< [OUT] Frame real width (allocate buffer size)
    VAL_UINT32_T    u4RealHeight;               ///< [OUT] Frame real height (allocate buffer size)
    VAL_UINT32_T    u4Timestamp;                ///< [OUT] Timestamp for last decode picture
    VAL_UINT32_T    u4AspectRatioW;             ///< [OUT] The horizontal size of the sample aspect ratio
    VAL_UINT32_T    u4AspectRatioH;             ///< [OUT] The vertical size of the sample aspect ratio
    VAL_UINT32_T    u4FrameRate;                ///< [OUT] One of VDEC_DRV_FRAME_RATE
    VAL_UINT32_T    u4PictureStructure;         ///< [OUT] One of VDEC_DRV_PIC_STRUCT
    VAL_UINT32_T    u4IsProgressiveOnly;        ///< [OUT] 1: Progressive only. 0: Not progressive only.
} VDEC_DRV_PICINFO_T;

/**
 * @par Structure
 *  P_VDEC_DRV_PICINFO_T
 * @par Description
 *  Pointer of VDEC_DRV_PICINFO_T
 */
typedef VDEC_DRV_PICINFO_T *P_VDEC_DRV_PICINFO_T;


/**
 * @par Structure
 *  VDEC_DRV_SEQINFO_T
 * @par Description
 *  Sequence information.
 *  - Including Width/Height
 */
typedef struct __VDEC_DRV_SEQINFO_T
{
    VAL_UINT32_T    u4Width;                    ///< [OUT] Sequence buffer width
    VAL_UINT32_T    u4Height;                   ///< [OUT] Sequence buffer height
    VAL_UINT32_T    u4PicWidth;                 ///< [OUT] Sequence display width
    VAL_UINT32_T    u4PicHeight;                ///< [OUT] Sequence display height
    VAL_INT32_T     i4AspectRatioWidth;         ///< [OUT] Sequence aspect ratio width
    VAL_INT32_T     i4AspectRatioHeight;        ///< [OUT] Sequence aspect ratio height
    VAL_BOOL_T      bIsThumbnail;               ///< [OUT] check thumbnail
} VDEC_DRV_SEQINFO_T;

/**
 * @par Structure
 *  P_VDEC_DRV_SEQINFO_T
 * @par Description
 *  Pointer of VDEC_DRV_SEQINFO_T
 */
typedef VDEC_DRV_SEQINFO_T *P_VDEC_DRV_SEQINFO_T;


/**
 * @par Structure
 *  VDEC_DRV_YUV_STRIDE_T
 * @par Description
 *  Y/UV Stride information
 */
typedef struct __VDEC_DRV_YUV_STRIDE_T
{
    unsigned int    u4YStride;                  ///< [IN] Y Stride
    unsigned int    u4UVStride;                 ///< [IN] UV Stride
} VDEC_DRV_YUV_STRIDE_T;

/**
 * @par Structure
 *  P_VDEC_DRV_YUV_STRIDE_T
 * @par Description
 *  Pointer of VDEC_DRV_YUV_STRIDE_T
 */
typedef VDEC_DRV_YUV_STRIDE_T *P_VDEC_DRV_YUV_STRIDE_T;

#define VDEC_DRV_CONCURRENCE_LIMIT_WFD       0x00000001
#define VDEC_DRV_CONCURRENCE_LIMIT_MHL       0x00000002
#define VDEC_DRV_CONCURRENCE_LIMIT_BLUETOOTH 0x00000004
#define VDEC_DRV_CONCURRENCE_LIMIT_MASK      0x00000007
/**
 * @par Structure
 *  VDEC_DRV_QUERY_VIDEO_FORMAT_T
 * @par Description
 *  Both input and output of type QUERY_VIDEO_FORMAT
 */
typedef struct __VDEC_DRV_QUERY_VIDEO_FORMAT_T
{
    VAL_UINT32_T            u4VideoFormat;          ///< [OUT] VDEC_DRV_VIDEO_FORMAT
    VAL_UINT32_T            u4Profile;              ///< [OUT] VDEC_DRV_VIDEO_PROFILE
    VAL_UINT32_T            u4Level;                ///< [OUT] VDEC_DRV_VIDEO_LEVEL
    VAL_UINT32_T            u4Resolution;           ///< [OUT] VDEC_DRV_RESOLUTION
    VAL_UINT32_T            u4Width;                ///< [OUT] Frame Width
    VAL_UINT32_T            u4Height;               ///< [OUT] Frame Height
    VAL_UINT32_T            u4StrideAlign;          ///< [OUT] Frame Stride Alignment
    VAL_UINT32_T            u4SliceHeightAlign;     ///< [OUT] Frame Slice Height Alignment
    VDEC_DRV_PIXEL_FORMAT_T ePixelFormat;           ///< [OUT] Frame Format
    VDEC_DRV_DECODER_TYPE_T eDecodeType;            ///< [OUT] Decoder type
    VAL_UINT32_T            u4CompatibleFlag;       ///< [OUT] CompatibleFlag
} VDEC_DRV_QUERY_VIDEO_FORMAT_T;

/**
 * @par Structure
 *  P_VDEC_DRV_QUERY_VIDEO_FORMAT_T
 * @par Description
 *  Pointer of VDEC_DRV_QUERY_VIDEO_FORMAT_T
 */
typedef VDEC_DRV_QUERY_VIDEO_FORMAT_T *P_VDEC_DRV_QUERY_VIDEO_FORMAT_T;


/**
 * @par Structure
 *  VDEC_DRV_SET_DECODE_MODE_T
 * @par Description
 *  [Unused]Set Decode Mode
 */
typedef struct __VDEC_DRV_SET_DECODE_MODE_T
{
    VDEC_DRV_DECODE_MODE_T  eDecodeMode;            ///< [IN/OUT] one of VDEC_DRV_DECODE_MODE
    VAL_UINT32_T            u4DisplayFrameNum;      ///< [IN/OUT] 0  8  7  6  5  4  3  2  1  1  1  1  1  1  1  1
    VAL_UINT32_T            u4DropFrameNum;         ///< [IN/OUT] 0  1  1  1  1  1  1  1  1  2  3  4  5  6  7  8
} VDEC_DRV_SET_DECODE_MODE_T;

/**
 * @par Structure
 *  P_VDEC_DRV_SET_DECODE_MODE_T
 * @par Description
 *  Pointer of VDEC_DRV_SET_DECODE_MODE_T
 */
typedef VDEC_DRV_SET_DECODE_MODE_T *P_VDEC_DRV_SET_DECODE_MODE_T;


/**
 * @par Structure
 *  VDEC_DRV_PROPERTY_T
 * @par Description
 *  VDecDrv property information
 */
typedef struct __VDEC_DRV_PROPERTY_T
{
    VAL_UINT32_T        u4BufAlign;                 ///< [OUT] buffer alignment requirement.
    VAL_UINT32_T        u4BufUnitSize;              ///< [OUT] buffer unit size is N bytes . (e.g., 8, 16, or 64 bytes per unit.)
    VAL_BOOL_T          fgPostprocessSupport;       ///< [OUT] support post-process.
    struct
    {
        VAL_UINT32_T    fgOverlay   : 1;            ///< [IN/OUT] Overlay flag
        VAL_UINT32_T    fgRotate    : 1;            ///< [IN/OUT] Rotate flag
        VAL_UINT32_T    fgResize    : 1;            ///< [IN/OUT] Resize flag
        VAL_UINT32_T    fgCrop      : 1;            ///< [IN/OUT] Croping flag
    } PostProcCapability;                           ///< [IN/OUT] Post process property
} VDEC_DRV_PROPERTY_T;

/**
 * @par Structure
 *  P_VDEC_DRV_PROPERTY_T
 * @par Description
 *  Pointer of VDEC_DRV_PROPERTY_T
 */
typedef VDEC_DRV_PROPERTY_T *P_VDEC_DRV_PROPERTY_T;


/**
 * @par Function:
 *   eVDecDrvQueryCapability
 * @par Description:
 *    - Query Decode Driver Capability
 *    - Input argument will be compare with driver's capability to check if the query is successful or not.
 * @param
 *   a_eType            [IN]  Driver query type, such as FBType, Video Format, etc.
 * @param
 *   a_pvInParam        [IN]  Input parameter for each type of query.
 * @param
 *   a_pvOutParam       [OUT] Store query result, such as FBType, Video Format, etc.
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Query Success
 *    - VDEC_DRV_MRESULT_FAIL: Query Fail
 */
VDEC_DRV_MRESULT_T  eVDecDrvQueryCapability(VDEC_DRV_QUERY_TYPE_T a_eType, VAL_VOID_T *a_pvInParam, VAL_VOID_T *a_pvOutParam);


/**
 * @par Function:
 *   eVDecDrvCreate
 * @par Description:
 *    - Create handle
 *    - Allocate extra data for each driver
 *      - According to the input parameter, "a_eVideoFormat."
 * @param
 *   a_phHandle         [IN/OUT] Driver handle
 * @param
 *   a_eVideoFormat     [IN]     Video format, such as MPEG4, H264, etc.
 * @par Returns:
 *   Reason for return value. Show the default returned value at which condition.
 *    - VDEC_DRV_MRESULT_OK:   Create handle successfully
 *    - VDEC_DRV_MRESULT_FAIL: Failed to create handle
 */
VDEC_DRV_MRESULT_T  eVDecDrvCreate(VAL_HANDLE_T *a_phHandle, VDEC_DRV_VIDEO_FORMAT_T a_eVideoFormat);


/**
 * @par Function:
 *   eVDecDrvRelease
 * @par Description:
 *    - Release Decode Driver
 *      - Need to perform driver deinit before driver release.
 *    - Procedure of release
 *      - Release extra data
 *      - Release handle
 * @param
 *   a_hHandle          [IN] Handle needed to be released.
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Release handle successfully.
 *    - VDEC_DRV_MRESULT_FAIL: Failed to release handle.
 */
VDEC_DRV_MRESULT_T  eVDecDrvRelease(VAL_HANDLE_T a_hHandle);


/**
 * @par Function:
 *   eVDecDrvInit
 * @par Description:
 *    - Initialize Decode Driver
 *    - Get width and height of bitstream
 * @param
 *   a_hHandle          [IN]  Driver handle
 * @param
 *   a_prBitstream      [IN]  Input bitstream for driver initialization
 * @param
 *   a_prSeqinfo        [OUT] Return width and height of bitstream
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Init driver successfully.
 *    - VDEC_DRV_MRESULT_FAIL: Failed to init driver.
 */
VDEC_DRV_MRESULT_T  eVDecDrvInit(VAL_HANDLE_T a_hHandle, VDEC_DRV_RINGBUF_T *a_prBitstream, VDEC_DRV_SEQINFO_T *a_prSeqinfo);


/**
 * @par Function:
 *   eVDecDrvDeInit
 * @par Description:
 *    - Deinitialize driver
 *      - Have to deinit driver before release driver
 * @param
 *   a_hHandle          [IN] Driver handle
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Deinit driver successfully.
 *    - VDEC_DRV_MRESULT_FAIL: Failed to deinit driver.
 */
VDEC_DRV_MRESULT_T  eVDecDrvDeInit(VAL_HANDLE_T a_hHandle);


/**
 * @par Function:
 *   eVDecDrvGetParam
 * @par Description:
 *    - Get driver's parameter
 *      - Type of parameter can be referred to VDEC_DRV_GET_TYPE_T.
 * @param
 *   a_hHandle          [IN]  Driver handle
 * @param
 *   a_eType            [IN]  Parameter type
 * @param
 *   a_pvInParam        [OUT] Input argument for query parameter.
 * @param
 *   a_pvOutParam       [OUT] Store output parameter
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Get parameter successfully.
 *    - VDEC_DRV_MRESULT_FAIL: Failed to get parameter.
 *      - Fail reason might be
 *        - wrong or unsupported parameter type
 *        - fail to get reference memory pool size.
 */
VDEC_DRV_MRESULT_T  eVDecDrvGetParam(VAL_HANDLE_T a_hHandle, VDEC_DRV_GET_TYPE_T a_eType, VAL_VOID_T *a_pvInParam, VAL_VOID_T *a_pvOutParam);


/**
 * @par Function:
 *   eVDecDrvSetParam
 * @par Description:
 *    - Set driver's parameters
 * @param
 *   a_hHandle          [IN]  driver handle
 * @param
 *   a_eType            [IN]  parameter type
 * @param
 * a_pvInParam          [IN]  input parameter
 * @param
 * a_pvOutParam         [OUT] output parameter
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Get parameter successfully.
 *    - VDEC_DRV_MRESULT_FAIL: Failed to get parameter.
 *      - Fail reason might be
 *        - wrong or unsupported parameter type
 *        - fail to set parameter
 */
VDEC_DRV_MRESULT_T  eVDecDrvSetParam(VAL_HANDLE_T a_hHandle, VDEC_DRV_SET_TYPE_T a_eType, VAL_VOID_T *a_pvInParam, VAL_VOID_T *a_pvOutParam);


/**
 * @par Function:
 *  eVDecDrvDecode
 * @par Description:
 *    - Trigger Decode
 *      - Need to Provide frame buffer to store unused buffer
 *    - The procedure of decode including:
 *      - Header parsing
 *      - trigger hw decode
 *    - While we want to decode the last frame, we need to set input bitstream as VAL_NULL and still give free frame buffer.
 * @param
 *   a_hHandle          [IN] driver handle
 * @param
 *   a_prBitstream      [IN] input bitstream
 * @param
 *   a_prFramebuf       [IN] free frame buffer
 * @par Returns:
 *    - VDEC_DRV_MRESULT_OK:   Decode successfully.
 *    - VDEC_DRV_MRESULT_FAIL: Failed to decode.
 */
VDEC_DRV_MRESULT_T  eVDecDrvDecode(VAL_HANDLE_T a_hHandle, VDEC_DRV_RINGBUF_T *a_prBitstream, VDEC_DRV_FRAMEBUF_T *a_prFramebuf);


#ifdef __cplusplus
}
#endif

#endif // #ifndef _VDEC_DRV_IF_PUBLIC_H_