Texas Instruments H.264 High Profile Encoder, Руководство пользователя

Страница: 126 / 139

API Reference
4-82
║
Name
process()
– basic encoding/decoding call
║
Synopsis
XDAS_Int32 (*process)(IVIDENC2_Handle handle,
IVIDEO2_BufDesc *inBufs, XDM2_BufDesc *outBufs,
IVIDENC2_InArgs *inargs, IVIDENC2_OutArgs *outargs);
║
Arguments
IVIDENC2_Handle handle; /* algorithm instance handle */
IVIDEO2_BufDesc *inBufs; /* algorithm input buffer
descriptor */
XDM2_BufDesc *outBufs; /* algorithm output buffer
descriptor */
IVIDENC2_InArgs *inargs /* algorithm runtime input
arguments */
IVIDENC2_OutArgs *outargs /* algorithm runtime output
arguments */
║ Return Value
IALG_EOK; /* status indicating success */
IALG_EFAIL; /* status indicating failure */
║
Description
This function does the basic encoding/decoding. The first argument to
process()
is a handle to an
algorithm instance.
The second and third arguments are pointers to the input and output buffer descriptor data
structures respectively (see
XDM_BufDesc
data structure for details).
The fourth argument is a pointer to the
IVIDENC2_InArgs
data structure that defines the run time
input arguments for an algorithm instance object.
The last argument is a pointer to the
IVIDENC2_OutArgs
data structure that defines the run time
output arguments for an algorithm instance object.
Note:
If you are using extended data structures, the fourth and fifth arguments
must be pointers to the extended
InArgs
and
OutArgs
data structures
respectively. Also, ensure that the
size
field is set to the size of the
extended data structure. Depending on the value set for the
size
field,
the algorithm uses either basic or extended parameters.
║ Preconditions
The following conditions must be true prior to calling this function; otherwise, its operation is
undefined.

process()
can only be called after a successful return from
algInit()
and
algActivate().