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

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

4-83
 If algorithm uses DMA resources,
process()
can only be called after a
successful return from
DMAN3_init().

handle
must be a valid handle for the algorithm’s instance object.
 Buffer descriptor for input and output buffers must be valid.
 Input buffers must have valid input data.

inBufs->numBufs
indicates the total number of input
 Buffers supplied for input frame, and conditionally, the encoders MB data
buffer.

inArgs
must not be NULL and must point to a valid
IVIDENC2_InArgs
structure.

outArgs
must not be NULL and must point to a valid
IVIDENC2_OutArgs
structure.

inBufs
must not be NULL and must point to a valid
IVIDEO1_BufDescIn
structure.

inBufs->bufDesc[0].bufs
must not be NULL, and must point to a valid
buffer of data that is at least
inBufs->bufDesc[0].bufSize
bytes in
length.

outBufs
must not be NULL and must point to a valid
XDM_BufDesc
structure.

outBufs->buf[0]
must not be NULL and must point to a valid buffer of
data that is at least
outBufs->bufSizes[0]
bytes in length.
 The buffers in
inBuf
and
outBuf
are physically contiguous and owned by
the calling application.
║
Postconditions
The following conditions are true immediately after returning from this function.
 If the process operation is successful, the return value from this operation
is equal to
IALG_EOK;
otherwise it is equal to either
IALG_EFAIL
or an
algorithm specific return value.

After successful return from
process()
function,
algDeactivate()
can
be called.
 The algorithm must not modify the contents of
inArgs
.
 The algorithm must not modify the contents of
inBufs
, with the exception
of
inBufs.bufDesc[].accessMask
. That is, the data and buffers pointed
to by these parameters must be treated as read-only.

The algorithm must appropriately set/clear the
IVIDEO2_BufDescIn::bufDesc[].accessMask
field in
inBufs
to
indicate the mode in which each of the buffers in
inBufs
were read. For
example, if the algorithm only read from
inBufs.bufDesc[0].buf
using
the algorithm processor, it could utilize
#XDM_SETACCESSMODE_READ
to