OpenMAX Bellagio 0.9.3
omx_base_port.h File Reference
#include "tsemaphore.h"
#include "queue.h"
#include "omx_classmagic.h"

Go to the source code of this file.

Data Structures

struct  omx_base_PortType
 

Macros

#define TUNNEL_USE_BUFFER_RETRY   20
 
#define TUNNEL_USE_BUFFER_RETRY_USLEEP_TIME   50000
 
#define PORT_IS_BEING_FLUSHED(pPort)   (pPort->bIsPortFlushed == OMX_TRUE)
 
#define PORT_IS_BEING_DISABLED(pPort)   (pPort->bIsTransientToDisabled == OMX_TRUE)
 
#define PORT_IS_ENABLED(pPort)   (pPort->sPortParam.bEnabled == OMX_TRUE)
 
#define PORT_IS_POPULATED(pPort)   (pPort->sPortParam.bPopulated == OMX_TRUE)
 
#define PORT_IS_TUNNELED(pPort)   (pPort->nTunnelFlags & TUNNEL_ESTABLISHED)
 
#define PORT_IS_DEEP_TUNNELED(pPort)   (pPort->nTunnelFlags & PROPRIETARY_COMMUNICATION_ESTABLISHED)
 
#define PORT_IS_BUFFER_SUPPLIER(pPort)   (pPort->nTunnelFlags & TUNNEL_IS_SUPPLIER)
 
#define PORT_IS_TUNNELED_N_BUFFER_SUPPLIER(pPort)   ((pPort->nTunnelFlags & TUNNEL_ESTABLISHED) && (pPort->nTunnelFlags & TUNNEL_IS_SUPPLIER))
 
#define omx_base_PortType_FIELDS
 

Typedefs

typedef enum BUFFER_STATUS_FLAG BUFFER_STATUS_FLAG
 
typedef enum TUNNEL_STATUS_FLAG TUNNEL_STATUS_FLAG
 the status of a port related to the tunneling with another component More...
 
typedef struct omx_base_PortType omx_base_PortType
 the base structure that describes each port. More...
 

Enumerations

enum  BUFFER_STATUS_FLAG { BUFFER_FREE = 0 , BUFFER_ALLOCATED = 0x0001 , BUFFER_ASSIGNED = 0x0002 , HEADER_ALLOCATED = 0x0004 }
 
enum  TUNNEL_STATUS_FLAG { NO_TUNNEL = 0 , TUNNEL_ESTABLISHED = 0x0001 , TUNNEL_IS_SUPPLIER = 0x0002 , PROPRIETARY_COMMUNICATION_ESTABLISHED = 0x0004 }
 the status of a port related to the tunneling with another component More...
 

Functions

OMX_ERRORTYPE base_port_Constructor (OMX_COMPONENTTYPE *openmaxStandComp, omx_base_PortType **openmaxStandPort, OMX_U32 nPortIndex, OMX_BOOL isInput)
 The base contructor for the generic OpenMAX ST port. More...
 
OMX_ERRORTYPE base_port_Destructor (omx_base_PortType *openmaxStandPort)
 The base destructor for the generic OpenMAX ST port. More...
 
OMX_ERRORTYPE base_port_DisablePort (omx_base_PortType *openmaxStandPort)
 Disables the port. More...
 
OMX_ERRORTYPE base_port_EnablePort (omx_base_PortType *openmaxStandPort)
 Enables the port. More...
 
OMX_ERRORTYPE base_port_SendBufferFunction (omx_base_PortType *openmaxStandPort, OMX_BUFFERHEADERTYPE *pBuffer)
 The entry point for sending buffers to the port. More...
 
OMX_ERRORTYPE base_port_AllocateBuffer (omx_base_PortType *openmaxStandPort, OMX_BUFFERHEADERTYPE **pBuffer, OMX_U32 nPortIndex, OMX_PTR pAppPrivate, OMX_U32 nSizeBytes)
 Called by the standard allocate buffer, it implements a base functionality. More...
 
OMX_ERRORTYPE base_port_UseBuffer (omx_base_PortType *openmaxStandPort, OMX_BUFFERHEADERTYPE **ppBufferHdr, OMX_U32 nPortIndex, OMX_PTR pAppPrivate, OMX_U32 nSizeBytes, OMX_U8 *pBuffer)
 Called by the standard use buffer, it implements a base functionality. More...
 
OMX_ERRORTYPE base_port_FreeBuffer (omx_base_PortType *openmaxStandPort, OMX_U32 nPortIndex, OMX_BUFFERHEADERTYPE *pBuffer)
 Called by the standard function. More...
 
OMX_ERRORTYPE base_port_FlushProcessingBuffers (omx_base_PortType *openmaxStandPort)
 Releases buffers under processing. More...
 
OMX_ERRORTYPE base_port_ReturnBufferFunction (omx_base_PortType *openmaxStandPort, OMX_BUFFERHEADERTYPE *pBuffer)
 Returns buffers when processed. More...
 
OMX_ERRORTYPE base_port_ComponentTunnelRequest (omx_base_PortType *openmaxStandPort, OMX_HANDLETYPE hTunneledComp, OMX_U32 nTunneledPort, OMX_TUNNELSETUPTYPE *pTunnelSetup)
 Setup Tunnel with the port. More...
 
OMX_ERRORTYPE base_port_AllocateTunnelBuffer (omx_base_PortType *openmaxStandPort, OMX_U32 nPortIndex)
 Allocate Buffers for tunneling use. More...
 
OMX_ERRORTYPE base_port_FreeTunnelBuffer (omx_base_PortType *openmaxStandPort, OMX_U32 nPortIndex)
 Free buffers used in tunnel. More...
 

Macro Definition Documentation

◆ omx_base_PortType_FIELDS

#define omx_base_PortType_FIELDS

Setup tunnel with the port

Definition at line 141 of file omx_base_port.h.

◆ PORT_IS_BEING_DISABLED

#define PORT_IS_BEING_DISABLED (   pPort)    (pPort->bIsTransientToDisabled == OMX_TRUE)

Definition at line 40 of file omx_base_port.h.

◆ PORT_IS_BEING_FLUSHED

#define PORT_IS_BEING_FLUSHED (   pPort)    (pPort->bIsPortFlushed == OMX_TRUE)

Port Specific Macro's

Definition at line 39 of file omx_base_port.h.

◆ PORT_IS_BUFFER_SUPPLIER

#define PORT_IS_BUFFER_SUPPLIER (   pPort)    (pPort->nTunnelFlags & TUNNEL_IS_SUPPLIER)

Definition at line 45 of file omx_base_port.h.

◆ PORT_IS_DEEP_TUNNELED

#define PORT_IS_DEEP_TUNNELED (   pPort)    (pPort->nTunnelFlags & PROPRIETARY_COMMUNICATION_ESTABLISHED)

Definition at line 44 of file omx_base_port.h.

◆ PORT_IS_ENABLED

#define PORT_IS_ENABLED (   pPort)    (pPort->sPortParam.bEnabled == OMX_TRUE)

Definition at line 41 of file omx_base_port.h.

◆ PORT_IS_POPULATED

#define PORT_IS_POPULATED (   pPort)    (pPort->sPortParam.bPopulated == OMX_TRUE)

Definition at line 42 of file omx_base_port.h.

◆ PORT_IS_TUNNELED

#define PORT_IS_TUNNELED (   pPort)    (pPort->nTunnelFlags & TUNNEL_ESTABLISHED)

Definition at line 43 of file omx_base_port.h.

◆ PORT_IS_TUNNELED_N_BUFFER_SUPPLIER

#define PORT_IS_TUNNELED_N_BUFFER_SUPPLIER (   pPort)    ((pPort->nTunnelFlags & TUNNEL_ESTABLISHED) && (pPort->nTunnelFlags & TUNNEL_IS_SUPPLIER))

Definition at line 46 of file omx_base_port.h.

◆ TUNNEL_USE_BUFFER_RETRY

#define TUNNEL_USE_BUFFER_RETRY   20

src/base/omx_base_port.h

Base class for OpenMAX ports to be used in derived components.

Copyright (C) 2007-2009 STMicroelectronics Copyright (C) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

Definition at line 33 of file omx_base_port.h.

◆ TUNNEL_USE_BUFFER_RETRY_USLEEP_TIME

#define TUNNEL_USE_BUFFER_RETRY_USLEEP_TIME   50000

Definition at line 34 of file omx_base_port.h.

Typedef Documentation

◆ BUFFER_STATUS_FLAG

The following enum values are used to characterize each buffer allocated or assigned to the component. A buffer list is created for each port of the component. The buffer can be assigned to the port, or owned by the port. The buffer flag are applied for each buffer in each port buffer list. The following use cases are currently implemented:

  • When the IL Client asks the component to allocate a buffer for a given port, with the call to AllocateBuffer, the buffer created is characterizeed by the flag BUFFER_ALLOCATED
  • When the IL Client asks the component to use a buffer allocated by the client itself, the buffer flag is BUFFER_ASSIGNED
  • When the component is tunneled by another component, and the first is supplier of the buffer, the buffer is marked with the BUFFER_ALLOCATED flag.
  • When the component is tunneled by another component, and the second is supplier of the buffer, the buffer is marked with the BUFFER_ASSIGNED flag.
  • The case of a buffer supplied by the first component but allocated by another component or another port inside the same component, as in the case of shared buffers, is not yet implemented in these components
  • During hte deallocation phase each buffer is marked with the BUFFER_FREE flag, so that the component can check if all the buffers have been deallocated before switch the component state to Loaded, as specified by the OpenMAX specs

◆ omx_base_PortType

the base structure that describes each port.

The data structure that describes a port contains the basic elements used in the base component. Other elements can be added in the derived components structures.

Definition at line 105 of file omx_base_port.h.

◆ TUNNEL_STATUS_FLAG

the status of a port related to the tunneling with another component

Enumeration Type Documentation

◆ BUFFER_STATUS_FLAG

The following enum values are used to characterize each buffer allocated or assigned to the component. A buffer list is created for each port of the component. The buffer can be assigned to the port, or owned by the port. The buffer flag are applied for each buffer in each port buffer list. The following use cases are currently implemented:

  • When the IL Client asks the component to allocate a buffer for a given port, with the call to AllocateBuffer, the buffer created is characterizeed by the flag BUFFER_ALLOCATED
  • When the IL Client asks the component to use a buffer allocated by the client itself, the buffer flag is BUFFER_ASSIGNED
  • When the component is tunneled by another component, and the first is supplier of the buffer, the buffer is marked with the BUFFER_ALLOCATED flag.
  • When the component is tunneled by another component, and the second is supplier of the buffer, the buffer is marked with the BUFFER_ASSIGNED flag.
  • The case of a buffer supplied by the first component but allocated by another component or another port inside the same component, as in the case of shared buffers, is not yet implemented in these components
  • During hte deallocation phase each buffer is marked with the BUFFER_FREE flag, so that the component can check if all the buffers have been deallocated before switch the component state to Loaded, as specified by the OpenMAX specs
Enumerator
BUFFER_FREE 
BUFFER_ALLOCATED 

This flag is applied to a buffer when it is allocated by the given port of the component

BUFFER_ASSIGNED 

This flag is applied to a buffer when it is assigned from another port or by the IL client

HEADER_ALLOCATED 

This flag is applied to a buffer when buffer header is allocated by the given port of the component

Definition at line 72 of file omx_base_port.h.

◆ TUNNEL_STATUS_FLAG

the status of a port related to the tunneling with another component

Enumerator
NO_TUNNEL 

No tunnel established

TUNNEL_ESTABLISHED 

the TUNNEL_ESTABLISHED specifies if a port is tunneled. It is assigned to a private field of the port if it is tunneled

TUNNEL_IS_SUPPLIER 

the TUNNEL_IS_SUPPLIER specifies if a tunneled port is the supplier. It is assigned to a private field of the port if it is tunneled and also it is the buffer supplier for the tunnel.

PROPRIETARY_COMMUNICATION_ESTABLISHED 

Definition at line 84 of file omx_base_port.h.

Function Documentation

◆ base_port_AllocateBuffer()

OMX_ERRORTYPE base_port_AllocateBuffer ( omx_base_PortType openmaxStandPort,
OMX_BUFFERHEADERTYPE **  pBuffer,
OMX_U32  nPortIndex,
OMX_PTR  pAppPrivate,
OMX_U32  nSizeBytes 
)

Called by the standard allocate buffer, it implements a base functionality.

This function can be overriden if the allocation of the buffer is not a simply malloc call. The parameters are the same as the standard function, except for the handle of the port instead of the handler of the component When the buffers needed by this port are all assigned or allocated, the variable bIsFullOfBuffers becomes equal to OMX_TRUE

This function can be overriden if the allocation of the buffer is not a simply alloc call. The parameters are the same as the standard function, except for the handle of the port instead of the handler of the component When the buffers needed by this port are all assigned or allocated, the variable bIsFullOfBuffers becomes equal to OMX_TRUE

Definition at line 383 of file omx_base_port.c.

References omx_base_PortType::bBufferStateAllocated, omx_base_PortType::bIsFullOfBuffers, omx_base_PortType::bIsTransientToEnabled, OMX_PARAM_PORTDEFINITIONTYPE::bPopulated, BUFFER_ALLOCATED, BUFFER_FREE, DEB_LEV_ERR, DEB_LEV_FUNCTION_NAME, DEB_LEV_PARAMS, DEB_LEV_SIMPLE_SEQ, DEBUG, OMX_PARAM_PORTDEFINITIONTYPE::eDir, HEADER_ALLOCATED, OMX_BUFFERHEADERTYPE::nAllocLen, OMX_PARAM_PORTDEFINITIONTYPE::nBufferCountActual, OMX_PARAM_PORTDEFINITIONTYPE::nBufferSize, OMX_BUFFERHEADERTYPE::nInputPortIndex, omx_base_PortType::nNumAssignedBuffers, OMX_BUFFERHEADERTYPE::nOutputPortIndex, OMX_PARAM_PORTDEFINITIONTYPE::nPortIndex, OMX_DirInput, OMX_ErrorBadPortIndex, OMX_ErrorIncorrectStateTransition, OMX_ErrorInsufficientResources, OMX_ErrorNone, OMX_TransStateLoadedToIdle, OMX_TRUE, omx_base_PortType::pAllocSem, OMX_BUFFERHEADERTYPE::pAppPrivate, OMX_BUFFERHEADERTYPE::pBuffer, OMX_COMPONENTTYPE::pComponentPrivate, omx_base_PortType::pInternalBufferStorage, PORT_IS_TUNNELED_N_BUFFER_SUPPLIER, OMX_BUFFERHEADERTYPE::pPlatformPrivate, setHeader(), omx_base_PortType::sPortParam, omx_base_PortType::standCompContainer, omx_base_component_PrivateType::transientState, and tsem_up().

Referenced by base_port_Constructor().

◆ base_port_AllocateTunnelBuffer()

OMX_ERRORTYPE base_port_AllocateTunnelBuffer ( omx_base_PortType openmaxStandPort,
OMX_U32  nPortIndex 
)

◆ base_port_ComponentTunnelRequest()

OMX_ERRORTYPE base_port_ComponentTunnelRequest ( omx_base_PortType openmaxStandPort,
OMX_HANDLETYPE  hTunneledComp,
OMX_U32  nTunneledPort,
OMX_TUNNELSETUPTYPE pTunnelSetup 
)

Setup Tunnel with the port.

Todo:
insert here a detailed comparison with the OMX_AUDIO_PORTDEFINITIONTYPE

Definition at line 1002 of file omx_base_port.c.

References OMX_PARAM_PORTDEFINITIONTYPE::audio, DEB_LEV_ERR, DEB_LEV_FULL_SEQ, DEB_LEV_FUNCTION_NAME, DEBUG, OMX_PARAM_BUFFERSUPPLIERTYPE::eBufferSupplier, omx_base_PortType::eBufferSupplier, OMX_VIDEO_PORTDEFINITIONTYPE::eCompressionFormat, OMX_PARAM_PORTDEFINITIONTYPE::eDir, OMX_PARAM_PORTDEFINITIONTYPE::eDomain, OMX_AUDIO_PORTDEFINITIONTYPE::eEncoding, OMX_OTHER_PORTDEFINITIONTYPE::eFormat, err, OMX_TUNNELSETUPTYPE::eSupplier, OMX_PARAM_PORTDEFINITIONTYPE::format, omx_base_PortType::hTunneledComponent, OMX_PARAM_PORTDEFINITIONTYPE::nBufferCountActual, omx_base_PortType::nNumTunnelBuffer, OMX_PARAM_PORTDEFINITIONTYPE::nPortIndex, OMX_PARAM_BUFFERSUPPLIERTYPE::nPortIndex, OMX_VENDOR_PROP_TUNNELSETUPTYPE::nPortIndex, omx_base_PortType::nTunneledPort, OMX_TUNNELSETUPTYPE::nTunnelFlags, omx_base_PortType::nTunnelFlags, OMX_AUDIO_CodingMax, OMX_BufferSupplyInput, OMX_BufferSupplyOutput, OMX_BufferSupplyUnspecified, OMX_DirInput, OMX_ErrorNone, OMX_ErrorPortsNotCompatible, OMX_GetParameter, OMX_IndexParamCompBufferSupplier, OMX_IndexParamPortDefinition, OMX_IndexVendorCompPropTunnelFlags, OMX_OTHER_FormatMax, OMX_PortDomainAudio, OMX_PortDomainOther, OMX_PortDomainVideo, OMX_PORTTUNNELFLAG_READONLY, OMX_SetParameter, OMX_VIDEO_CodingMax, OMX_PARAM_PORTDEFINITIONTYPE::other, PORT_IS_DEEP_TUNNELED, PROPRIETARY_COMMUNICATION_ESTABLISHED, setHeader(), omx_base_PortType::sPortParam, TUNNEL_ESTABLISHED, TUNNEL_IS_SUPPLIER, and OMX_PARAM_PORTDEFINITIONTYPE::video.

Referenced by base_port_Constructor().

◆ base_port_Constructor()

OMX_ERRORTYPE base_port_Constructor ( OMX_COMPONENTTYPE openmaxStandComp,
omx_base_PortType **  openmaxStandPort,
OMX_U32  nPortIndex,
OMX_BOOL  isInput 
)

The base contructor for the generic OpenMAX ST port.

This function is executed by the component that uses a port. The parameter contains the info about the component. It takes care of constructing the instance of the port and every object needed by the base port.

Parameters
openmaxStandPortthe ST port to be initialized
Returns
OMX_ErrorInsufficientResources if a memory allocation fails

This function is executed by the component that uses a port. The parameter contains the info about the component. It takes care of constructing the instance of the port and every object needed by the base port.

Parameters
openmaxStandCompin the component that holds the port
openmaxStandPortthe ST port to be initialized
nPortIndexthe index of the port
isInputspecifies if the port is an input or an output
Returns
OMX_ErrorInsufficientResources if a memory allocation fails

Allocate and initialize buffer queue

Definition at line 55 of file omx_base_port.c.

References base_port_AllocateBuffer(), base_port_AllocateTunnelBuffer(), base_port_ComponentTunnelRequest(), base_port_Destructor(), base_port_DisablePort(), base_port_EnablePort(), base_port_FlushProcessingBuffers(), base_port_FreeBuffer(), base_port_FreeTunnelBuffer(), base_port_ReturnBufferFunction(), base_port_SendBufferFunction(), base_port_UseBuffer(), DEB_LEV_ERR, DEB_LEV_FUNCTION_NAME, DEBUG, DEFAULT_MIN_NUMBER_BUFFERS_PER_PORT, DEFAULT_NUMBER_BUFFERS_PER_PORT, OMX_BufferSupplyUnspecified, OMX_DirInput, OMX_DirOutput, OMX_ErrorInsufficientResources, OMX_ErrorNone, OMX_FALSE, OMX_TRUE, queue_init(), setHeader(), and tsem_init().

Referenced by base_audio_port_Constructor(), base_clock_port_Constructor(), base_image_port_Constructor(), and base_video_port_Constructor().

◆ base_port_Destructor()

OMX_ERRORTYPE base_port_Destructor ( omx_base_PortType openmaxStandPort)

The base destructor for the generic OpenMAX ST port.

This function is executed by the component that uses a port. The parameter contains the info about the component. It takes care of destructing the instance of the port and every object used by the base port.

Parameters
openmaxStandPortthe ST port to be disposed

TODO This semaphore, if activated, can cause memory leaks. It can be necessary to avoid to wait forever if the other component in tunnel doesn't perform required actions. This operation can be timed but can cause problems. Currently it is left commented for reference. tsem_up(openmaxStandPort->pAllocSem);

Allocate and initialize buffer queue

Definition at line 134 of file omx_base_port.c.

References omx_base_PortType::bIsDestroying, DEB_LEV_FUNCTION_NAME, DEBUG, omx_base_PortType::exitMutex, OMX_ErrorNone, OMX_TRUE, omx_base_PortType::pAllocSem, omx_base_PortType::pBufferQueue, omx_base_PortType::pBufferSem, queue_deinit(), and tsem_deinit().

Referenced by base_audio_port_Destructor(), base_clock_port_Destructor(), base_image_port_Destructor(), base_port_Constructor(), and base_video_port_Destructor().

◆ base_port_DisablePort()

◆ base_port_EnablePort()

◆ base_port_FlushProcessingBuffers()

OMX_ERRORTYPE base_port_FlushProcessingBuffers ( omx_base_PortType openmaxStandPort)

◆ base_port_FreeBuffer()

OMX_ERRORTYPE base_port_FreeBuffer ( omx_base_PortType openmaxStandPort,
OMX_U32  nPortIndex,
OMX_BUFFERHEADERTYPE pBuffer 
)

Called by the standard function.

It frees the buffer header and in case also the buffer itself, if needed. When all the bufers are done, the variable bIsEmptyOfBuffers is set to OMX_TRUE

It frees the buffer header and in case also the buffer itself, if needed. When all the buffers are done, the variable bIsEmptyOfBuffers is set to OMX_TRUE

Definition at line 547 of file omx_base_port.c.

References omx_base_PortType::bBufferStateAllocated, omx_base_PortType::bIsEmptyOfBuffers, omx_base_PortType::bIsFullOfBuffers, omx_base_PortType::bIsTransientToDisabled, OMX_PARAM_PORTDEFINITIONTYPE::bPopulated, BUFFER_ALLOCATED, BUFFER_ASSIGNED, BUFFER_FREE, omx_base_component_PrivateType::callbackData, omx_base_component_PrivateType::callbacks, DEB_LEV_ERR, DEB_LEV_FULL_SEQ, DEB_LEV_FUNCTION_NAME, DEB_LEV_PARAMS, DEBUG, OMX_CALLBACKTYPE::EventHandler, HEADER_ALLOCATED, OMX_PARAM_PORTDEFINITIONTYPE::nBufferCountActual, omx_base_PortType::nNumAssignedBuffers, OMX_PARAM_PORTDEFINITIONTYPE::nPortIndex, OMX_ErrorBadPortIndex, OMX_ErrorInsufficientResources, OMX_ErrorNone, OMX_ErrorPortUnpopulated, OMX_EventError, OMX_FALSE, OMX_TransStateIdleToLoaded, OMX_TRUE, omx_base_PortType::pAllocSem, OMX_BUFFERHEADERTYPE::pBuffer, OMX_COMPONENTTYPE::pComponentPrivate, omx_base_PortType::pInternalBufferStorage, PORT_IS_TUNNELED_N_BUFFER_SUPPLIER, omx_base_PortType::sPortParam, omx_base_PortType::standCompContainer, omx_base_component_PrivateType::transientState, and tsem_up().

Referenced by base_port_Constructor().

◆ base_port_FreeTunnelBuffer()

◆ base_port_ReturnBufferFunction()

◆ base_port_SendBufferFunction()

OMX_ERRORTYPE base_port_SendBufferFunction ( omx_base_PortType openmaxStandPort,
OMX_BUFFERHEADERTYPE pBuffer 
)

The entry point for sending buffers to the port.

This function can be called by the EmptyThisBuffer or FillThisBuffer. It depends on the nature of the port, that can be an input or output port.

The entry point for sending buffers to the port.

This function can be called by the EmptyThisBuffer or FillThisBuffer. It depends on the nature of the port, that can be an input or output port.

Definition at line 818 of file omx_base_port.c.

References omx_base_component_PrivateType::bMgmtSem, checkHeader(), DEB_LEV_ERR, DEB_LEV_FULL_SEQ, DEB_LEV_FUNCTION_NAME, DEB_LEV_PARAMS, DEBUG, OMX_PARAM_PORTDEFINITIONTYPE::eDir, err, omx_base_component_PrivateType::name, OMX_PARAM_PORTDEFINITIONTYPE::nBufferCountActual, OMX_BUFFERHEADERTYPE::nInputPortIndex, OMX_BUFFERHEADERTYPE::nOutputPortIndex, OMX_PARAM_PORTDEFINITIONTYPE::nPortIndex, OMX_DirInput, OMX_ErrorBadParameter, OMX_ErrorBadPortIndex, OMX_ErrorIncorrectStateOperation, OMX_ErrorInsufficientResources, OMX_ErrorInvalidState, OMX_ErrorNone, OMX_FALSE, OMX_StateExecuting, OMX_StateIdle, OMX_StateInvalid, OMX_StatePause, OMX_TransStateExecutingToIdle, OMX_TransStatePauseToIdle, OMX_TRUE, OMX_BUFFERHEADERTYPE::pBuffer, omx_base_PortType::pBufferQueue, omx_base_PortType::pBufferSem, OMX_COMPONENTTYPE::pComponentPrivate, omx_base_PortType::pInternalBufferStorage, PORT_IS_BEING_DISABLED, PORT_IS_BEING_FLUSHED, PORT_IS_BUFFER_SUPPLIER, PORT_IS_ENABLED, PORT_IS_TUNNELED, PORT_IS_TUNNELED_N_BUFFER_SUPPLIER, queue(), omx_base_PortType::sPortParam, omx_base_PortType::standCompContainer, omx_base_component_PrivateType::state, omx_base_component_PrivateType::transientState, and tsem_up().

Referenced by base_port_Constructor().

◆ base_port_UseBuffer()

OMX_ERRORTYPE base_port_UseBuffer ( omx_base_PortType openmaxStandPort,
OMX_BUFFERHEADERTYPE **  ppBufferHdr,
OMX_U32  nPortIndex,
OMX_PTR  pAppPrivate,
OMX_U32  nSizeBytes,
OMX_U8 pBuffer 
)

Called by the standard use buffer, it implements a base functionality.

This function can be overriden if the use buffer implicate more complicated operations. The parameters are the same as the standard function, except for the handle of the port instead of the handler of the component When the buffers needed by this port are all assigned or allocated, the variable bIsFullOfBuffers becomes equal to OMX_TRUE

This function can be overriden if the use buffer implicate more complicated operations. The parameters are the same as the standard function, except for the handle of the port instead of the handler of the component. When the buffers needed by this port are all assigned or allocated, the variable bIsFullOfBuffers becomes equal to OMX_TRUE

Definition at line 462 of file omx_base_port.c.

References omx_base_PortType::bBufferStateAllocated, omx_base_PortType::bIsEmptyOfBuffers, omx_base_PortType::bIsFullOfBuffers, omx_base_PortType::bIsTransientToEnabled, OMX_PARAM_PORTDEFINITIONTYPE::bPopulated, BUFFER_ASSIGNED, BUFFER_FREE, DEB_LEV_ERR, DEB_LEV_FUNCTION_NAME, DEB_LEV_PARAMS, DEBUG, OMX_PARAM_PORTDEFINITIONTYPE::eDir, HEADER_ALLOCATED, OMX_BUFFERHEADERTYPE::nAllocLen, omx_base_component_PrivateType::name, OMX_PARAM_PORTDEFINITIONTYPE::nBufferCountActual, OMX_PARAM_PORTDEFINITIONTYPE::nBufferSize, OMX_BUFFERHEADERTYPE::nInputPortIndex, omx_base_PortType::nNumAssignedBuffers, OMX_BUFFERHEADERTYPE::nOutputPortIndex, OMX_PARAM_PORTDEFINITIONTYPE::nPortIndex, OMX_DirInput, OMX_ErrorBadPortIndex, OMX_ErrorIncorrectStateTransition, OMX_ErrorInsufficientResources, OMX_ErrorNone, OMX_FALSE, OMX_TransStateLoadedToIdle, OMX_TRUE, omx_base_PortType::pAllocSem, OMX_BUFFERHEADERTYPE::pAppPrivate, OMX_BUFFERHEADERTYPE::pBuffer, OMX_COMPONENTTYPE::pComponentPrivate, omx_base_PortType::pInternalBufferStorage, PORT_IS_TUNNELED_N_BUFFER_SUPPLIER, OMX_BUFFERHEADERTYPE::pPlatformPrivate, setHeader(), omx_base_PortType::sPortParam, omx_base_PortType::standCompContainer, omx_base_component_PrivateType::transientState, and tsem_up().

Referenced by base_port_Constructor().


Generated for OpenMAX Bellagio rel. 0.9.3 by  doxygen 1.5.1
SourceForge.net Logo