SysLink API Reference
2.21.03.11
|
Defines for interfaces for FrameQBufMgr module. (Deprecated)
Go to the source code of this file.
Data Structures | |
struct | FrameQBufMgr_Config_Tag |
Structure defining module config parameters for the FrameQBufMgr module. More... | |
struct | FrameQBufMgr_CreateParams_Tag |
Common parameters required to create FrameQBufMgr instance of any implementation. More... | |
struct | FrameQBufMgr_CommonOpenParams_Tag |
Common parameters required to open a FrameQBufMgr instance of any implementation. More... | |
struct | FrameQBufMgr_Params |
Common parameters required to create FrameQBufMgr instance of any implementation. More... | |
struct | FrameQBufMgr_FrameBufParams_Tag |
Frame buffer param structure. More... | |
struct | FrameQBufMgr_NotifyParams_Tag |
Structure defining notification parameter structure. More... |
Macros | |
#define | FrameQBufMgr_S_ALREADYDESTROYED 2 |
Indicates module has been already destroyed. | |
#define | FrameQBufMgr_S_ALREADYSETUP 1 |
Indicates module is already setup. | |
#define | FrameQBufMgr_S_SUCCESS 0 |
Operation successful. | |
#define | FrameQBufMgr_E_FAIL -1 |
General Failure. | |
#define | FrameQBufMgr_E_INVALIDARG -2 |
Invalid arguments are passed to FrameQBufMgr API. | |
#define | FrameQBufMgr_E_NOTFOUND -3 |
Instance not found. | |
#define | FrameQBufMgr_E_INST_EXISTS -4 |
FrameQBufMgr instance already exists. | |
#define | FrameQBufMgr_E_ALLOC_BUF -5 |
Failed to allocate buffer. | |
#define | FrameQBufMgr_E_ALLOC_MEMORY -6 |
Failed to allocate memory. | |
#define | FrameQBufMgr_E_CREATE_NAMESERVER -7 |
Name server create failed for the module. | |
#define | FrameQBufMgr_E_FAIL_CLIENTN0TIFYMGR_CREATE -8 |
ClientNotifyMgr create failed. | |
#define | FrameQBufMgr_E_CLIENTN0TIFYMGR_OPEN -9 |
ClientNotifyMgr open failed. | |
#define | FrameQBufMgr_E_CREATE_GATEMP -10 |
Creation of GateMP failed. | |
#define | FrameQBufMgr_E_OPEN_GATEMP -11 |
GateMP open failed. | |
#define | FrameQBufMgr_E_MAX_CLIENTS -12 |
Maximum instances limit reached. | |
#define | FrameQBufMgr_E_ACCESSDENIED -13 |
Operation can not be permitted or not implemented. | |
#define | FrameQBufMgr_E_NOTIMPLEMENTED -14 |
API is not implemented. | |
#define | FrameQBufMgr_E_INVALIDSTATE -15 |
Module is not initialized. | |
#define | FrameQBufMgr_E_OSFAILURE -16 |
Failure in OS call. | |
#define | FrameQBufMgr_E_MAXINSTANCES -17 |
Max instances limit reached. Can not create instance. | |
#define | FrameQBufMgr_E_INVALID_INTERFACE -18 |
Unsupported interface type. | |
#define | FrameQBufMgr_E_OPEN_NAMESERVER -19 |
Failed to open NameServer. | |
#define | FrameQBufMgr_E_INSUFFICIENT_HDRBUFS -20 |
Insufficient header buffers. | |
#define | FrameQBufMgr_E_ALLOC_FRAME -21 |
Failed to allocate frame. | |
#define | FrameQBufMgr_E_ALLOC_ALLFRAMES -22 |
Not able to allocate the requested frames.Able to allocate only few frames. | |
#define | FrameQBufMgr_E_INVALID_MEMMGRTYPE -23 |
Invalid MemMgr type specified. | |
#define | FrameQBufMgr_E_INVALID_HDRINTERFACETYPE -24 |
Invalid Header buffer interface type specified.see enum FrameQBufMgr_FrameHeaderInterface for the supported types. | |
#define | FrameQBufMgr_E_INVALID_BUFINTERFACETYPE -25 |
Invalid frame buffer interface type specified.see enum FrameQBufMgr_FrameBufferInterface for the supported types. | |
#define | FrameQBufMgr_E_NAMESERVERADD -33 |
NameServer_add failed. | |
#define | FrameQBufMgr_FrameBufInfo Frame_FrameBufInfo |
#define | FrameQBufMgr_FrameHeader Frame_FrameHeader |
Defines the frame header structure. | |
#define | FrameQBufMgr_MAXNAMELEN (32u) |
Maximum length of the name string in bytes. | |
#define | FrameQBufMgr_MAXINSTANCES (64u) |
Maximum number of instances managed by FrameQBufMgr module. | |
#define | FrameQBufMgr_MAX_POOLS (64u) |
Maximum number of free frame pools to be maintained in a instance. | |
#define | FrameQBufMgr_MAX_FRAMEBUFS (8) |
Maximum number of frame buffers in a frame managed by in FrameQBufMgr instance. | |
#define | FrameQBufMgr_POOL_MAXFRAMES (32) |
Maximum number of static free Frames managed by FrameQBufMgr instance Free Frame pool. | |
#define | FrameQBufMgr_POOL_MAXHDRS (64) |
Maximum number of additional static free headers managed by FrameQBufMgr instance for each Free Frame pool. | |
#define | FrameQBufMgr_POOL_DYNAMIC_MAXFRAMES (1) |
Maximum number of dynbuffers managed by each buffer pool in FrameQBufMgr instance. | |
#define | FrameQBufMgr_POOL_DYNAMIC_MAXHDRS (1) |
Maximum number of additional dynamic free headers managed by FrameQBufMgr instance for each Free Frame pool. | |
#define | FrameQBufMgr_NOTIFY_RESERVED_EVENTNO (0u) |
Notify Event Number to be used by FrameQBufMgr module. | |
#define | FrameQBufMgr_MAX_FRAMESINVAPI (FrameQ_MAX_FRAMESINVAPI) |
Macro used in FrameQ for sorting of passed parameters in V API. In FrameQBufMgr_allocv case this denotes the number of frames that can be allocated in one call. |
Typedefs | |
typedef struct FrameQBufMgr_Object * | FrameQBufMgr_Handle |
Handle for the FrameQBufMgr instance. | |
typedef Frame_FrameHeader * | FrameQBufMgr_Frame |
Defines the type for a frame pointer. | |
typedef enum FrameQBufMgr_CpuAccessFlags_Tag | FrameQBufMgr_CpuAccessFlags |
Enumeration of CPU access flags for frame buffers. For frame headers CPUACCESS is assumed to be TRUE.. | |
typedef enum FrameQBufMgr_BufType_Tag | FrameQBufMgr_BufType |
Denotes the type of buffer. | |
typedef enum FrameQBufMgr_AddrType_Tag | FrameQBufMgr_AddrType |
Enumerations to indicate address types used for translation. | |
typedef enum FrameQBufMgr_Interface_Tag | FrameQBufMgr_Interface |
Enumeration of FrameQBufMgr interface types.Denotes different implementation types. | |
typedef enum FrameQBufMgr_FrameHeaderInterface_Tag | FrameQBufMgr_FrameHeaderInterface |
Enumeration of FrameQBufMgr interface types.Denotes different implementation types. | |
typedef enum FrameQBufMgr_FrameBufferInterface_Tag | FrameQBufMgr_FrameBufferInterface |
Enumeration of FrameQBufMgr interface types.Denotes different implementation types. | |
typedef struct FrameQBufMgr_Config_Tag | FrameQBufMgr_Config |
Structure defining module config parameters for the FrameQBufMgr module. | |
typedef struct FrameQBufMgr_CreateParams_Tag | FrameQBufMgr_CreateParams |
Common parameters required to create FrameQBufMgr instance of any implementation. | |
typedef struct FrameQBufMgr_CommonOpenParams_Tag | FrameQBufMgr_CommonOpenParams |
Common parameters required to open a FrameQBufMgr instance of any implementation. | |
typedef struct FrameQBufMgr_Params | FrameQBufMgr_Params |
Common parameters required to create FrameQBufMgr instance of any implementation. | |
typedef struct FrameQBufMgr_FrameBufParams_Tag | FrameQBufMgr_FrameBufParams |
Frame buffer param structure. | |
typedef void(* | FrameQBufMgr_NotifyFunc )(FrameQBufMgr_Handle, Ptr arg, UInt32) |
Prototype of the FrameQBufMgr call back function. | |
typedef struct FrameQBufMgr_NotifyParams_Tag | FrameQBufMgr_NotifyParams |
Structure defining notification parameter structure. |
Functions | |
Int32 | FrameQBufMgr_setup (FrameQBufMgr_Config *cfg) |
Function to setup the FrameQBufMgr module. | |
Int32 | FrameQBufMgr_destroy (Void) |
Function to destroy(finalize) the FrameQBufMgr module. | |
FrameQBufMgr_Handle | FrameQBufMgr_create (Ptr params) |
Function to create FrameQBufMgr instance. | |
Int32 | FrameQBufMgr_delete (FrameQBufMgr_Handle *pHandle) |
Function to delete FrameQBufMgr instance. | |
Int32 | FrameQBufMgr_open (FrameQBufMgr_Handle *handlePtr, Ptr openParams) |
Function to open the created FrameQBufMgr instance. | |
Int32 | FrameQBufMgr_openByAddr (FrameQBufMgr_Handle *handlePtr, Ptr openParams) |
Function to open the created FrameQBufMgr instance using the address provided in open params. | |
Int32 | FrameQBufMgr_close (FrameQBufMgr_Handle *pHandle) |
Function to close the opened FrameQBufMgr instance. | |
Int32 | FrameQBufMgr_alloc (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame *frame) |
Function to allocate frame from free frame pool zero. | |
Int32 | FrameQBufMgr_allocv (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame framePtr[], UInt32 freeQId[], UInt8 *numFrames) |
Function to allocate multiple frames from the FrameQbufMgr instance.. | |
Int32 | FrameQBufMgr_free (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame frame) |
Function to free frame. | |
Int32 | FrameQBufMgr_freev (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame framePtr[], UInt32 numFrames) |
Function to free multiple frames to the FrameQBufMgr. | |
Ptr | FrameQBufMgr_add (FrameQBufMgr_Handle handle, UInt8 freeQId) |
Function to add frame. | |
Int32 | FrameQBufMgr_remove (FrameQBufMgr_Handle handle, UInt8 freeQId, FrameQBufMgr_Frame framePtr) |
Function to remove frame. | |
Int32 | FrameQBufMgr_dup (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame framePtr, FrameQBufMgr_Frame dupedFramePtr[], UInt32 numDupedFrames) |
Function to duplicate the frame. | |
Int32 | FrameQBufMgr_dupv (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame framePtr[], FrameQBufMgr_Frame **dupedFramePtr, UInt32 numDupedFrames, UInt32 numFrames) |
Function to duplicate the multiple frames. | |
Int32 | FrameQBufMgr_registerNotifier (FrameQBufMgr_Handle handle, FrameQBufMgr_NotifyParams *notifyParams) |
Function to register call back function for notification. | |
Int32 | FrameQBufMgr_unregisterNotifier (FrameQBufMgr_Handle handle) |
Function to unregister call back function. | |
Int32 | FrameQBufMgr_writeBack (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame framePtr) |
Function to write back the frame. | |
Int32 | FrameQBufMgr_writeBackBuf (FrameQBufMgr_Handle handle, Ptr buf, UInt32 flags) |
Write back the contents of buffer. | |
Int32 | FrameQBufMgr_invalidate (FrameQBufMgr_Handle handle, FrameQBufMgr_Frame framePtr) |
Function to invalidate frame. | |
Int32 | FrameQBufMgr_invalidateFrameBuf (FrameQBufMgr_Handle handle, Ptr frameBuf, UInt32 size, UInt8 bufIndexInFrame) |
Function to invalidate frame buffer. | |
Int32 | FrameQBufMgr_writeBackFrameBuf (FrameQBufMgr_Handle handle, Ptr frameBuf, UInt32 size, UInt8 bufIndexInFrame) |
Function to writeback frame buffer. | |
Int32 | FrameQBufMgr_invalidateHeaderBuf (FrameQBufMgr_Handle handle, Ptr headerBuf) |
Invalidate the contents of frame header. | |
Int32 | FrameQBufMgr_writeBackHeaderBuf (FrameQBufMgr_Handle handle, Ptr headerBuf) |
Write back the contents of frame header. | |
Int32 | FrameQBufMgr_translateAddr (FrameQBufMgr_Handle handle, Ptr *dstAddr, FrameQBufMgr_AddrType dstAddrType, Ptr srcAddr, FrameQBufMgr_AddrType srcAddrType, FrameQBufMgr_BufType bufType) |
API to translate the given pointer to other address type. | |
Int32 | FrameQBufMgr_getConfig (FrameQBufMgr_Config *cfg) |
Function to initialize the config parameter structure with default values. | |
UInt32 | FrameQBufMgr_getId (FrameQBufMgr_Handle handle) |
API to get the ID of the instance. | |
Ptr | FrameQBufMgr_getHandle (UInt32 Id) |
API to get the handle of the instance. | |
Bool | FrameQBufMgr_isCacheEnabledForHeaderBuf (FrameQBufMgr_Handle handle) |
Function to determine whether cache calls(writeback/invalidate) are enabled for frame headers. | |
Bool | FrameQBufMgr_isCacheEnabledForFrameBuf (FrameQBufMgr_Handle handle, UInt8 framebufIndex) |
Function to determine whether cache calls(writeback/invalidate) are enabled for frame headers. | |
Int32 | FrameQBufMgr_getNumFreeFrames (FrameQBufMgr_Handle handle, UInt32 *numFreeFrames) |
Function to get the number of free frames availabel in pool 0. | |
Int32 | FrameQBufMgr_control (FrameQBufMgr_Handle handle, Int32 cmd, Ptr arg) |
Provides a hook to perform implementation dependent operation. | |
UInt32 | FrameQBufMgr_getBaseHeaderSize (UInt8 numFrameBufs) |
Function to calcaulate the base frame header size when number of frames in a frame is given. | |
Ptr | FrameQBufMgr_getKnlHandle (FrameQBufMgr_Handle handle) |
Function to get the kernel space handle of the instance. |
#define FrameQBufMgr_S_ALREADYDESTROYED 2 |
Indicates module has been already destroyed.
#define FrameQBufMgr_S_ALREADYSETUP 1 |
Indicates module is already setup.
#define FrameQBufMgr_S_SUCCESS 0 |
Operation successful.
#define FrameQBufMgr_E_FAIL -1 |
General Failure.
#define FrameQBufMgr_E_INVALIDARG -2 |
Invalid arguments are passed to FrameQBufMgr API.
#define FrameQBufMgr_E_NOTFOUND -3 |
Instance not found.
#define FrameQBufMgr_E_INST_EXISTS -4 |
FrameQBufMgr instance already exists.
#define FrameQBufMgr_E_ALLOC_BUF -5 |
Failed to allocate buffer.
#define FrameQBufMgr_E_ALLOC_MEMORY -6 |
Failed to allocate memory.
#define FrameQBufMgr_E_CREATE_NAMESERVER -7 |
Name server create failed for the module.
#define FrameQBufMgr_E_FAIL_CLIENTN0TIFYMGR_CREATE -8 |
ClientNotifyMgr create failed.
#define FrameQBufMgr_E_CLIENTN0TIFYMGR_OPEN -9 |
ClientNotifyMgr open failed.
#define FrameQBufMgr_E_CREATE_GATEMP -10 |
Creation of GateMP failed.
#define FrameQBufMgr_E_OPEN_GATEMP -11 |
GateMP open failed.
#define FrameQBufMgr_E_MAX_CLIENTS -12 |
Maximum instances limit reached.
#define FrameQBufMgr_E_ACCESSDENIED -13 |
Operation can not be permitted or not implemented.
#define FrameQBufMgr_E_NOTIMPLEMENTED -14 |
API is not implemented.
#define FrameQBufMgr_E_INVALIDSTATE -15 |
Module is not initialized.
#define FrameQBufMgr_E_OSFAILURE -16 |
Failure in OS call.
#define FrameQBufMgr_E_MAXINSTANCES -17 |
Max instances limit reached. Can not create instance.
#define FrameQBufMgr_E_INVALID_INTERFACE -18 |
Unsupported interface type.
#define FrameQBufMgr_E_OPEN_NAMESERVER -19 |
Failed to open NameServer.
#define FrameQBufMgr_E_INSUFFICIENT_HDRBUFS -20 |
Insufficient header buffers.
#define FrameQBufMgr_E_ALLOC_FRAME -21 |
Failed to allocate frame.
#define FrameQBufMgr_E_ALLOC_ALLFRAMES -22 |
Not able to allocate the requested frames.Able to allocate only few frames.
#define FrameQBufMgr_E_INVALID_MEMMGRTYPE -23 |
Invalid MemMgr type specified.
#define FrameQBufMgr_E_INVALID_HDRINTERFACETYPE -24 |
Invalid Header buffer interface type specified.see enum FrameQBufMgr_FrameHeaderInterface for the supported types.
#define FrameQBufMgr_E_INVALID_BUFINTERFACETYPE -25 |
Invalid frame buffer interface type specified.see enum FrameQBufMgr_FrameBufferInterface for the supported types.
#define FrameQBufMgr_E_NAMESERVERADD -33 |
NameServer_add failed.
#define FrameQBufMgr_FrameBufInfo Frame_FrameBufInfo |
#define FrameQBufMgr_FrameHeader Frame_FrameHeader |
Defines the frame header structure.
#define FrameQBufMgr_MAXNAMELEN (32u) |
Maximum length of the name string in bytes.
#define FrameQBufMgr_MAXINSTANCES (64u) |
Maximum number of instances managed by FrameQBufMgr module.
#define FrameQBufMgr_MAX_POOLS (64u) |
Maximum number of free frame pools to be maintained in a instance.
#define FrameQBufMgr_MAX_FRAMEBUFS (8) |
Maximum number of frame buffers in a frame managed by in FrameQBufMgr instance.
#define FrameQBufMgr_POOL_MAXFRAMES (32) |
Maximum number of static free Frames managed by FrameQBufMgr instance Free Frame pool.
#define FrameQBufMgr_POOL_MAXHDRS (64) |
Maximum number of additional static free headers managed by FrameQBufMgr instance for each Free Frame pool.
#define FrameQBufMgr_POOL_DYNAMIC_MAXFRAMES (1) |
Maximum number of dynbuffers managed by each buffer pool in FrameQBufMgr instance.
#define FrameQBufMgr_POOL_DYNAMIC_MAXHDRS (1) |
Maximum number of additional dynamic free headers managed by FrameQBufMgr instance for each Free Frame pool.
#define FrameQBufMgr_NOTIFY_RESERVED_EVENTNO (0u) |
Notify Event Number to be used by FrameQBufMgr module.
#define FrameQBufMgr_MAX_FRAMESINVAPI (FrameQ_MAX_FRAMESINVAPI) |
Macro used in FrameQ for sorting of passed parameters in V API. In FrameQBufMgr_allocv case this denotes the number of frames that can be allocated in one call.
typedef struct FrameQBufMgr_Object* FrameQBufMgr_Handle |
Handle for the FrameQBufMgr instance.
typedef Frame_FrameHeader* FrameQBufMgr_Frame |
Defines the type for a frame pointer.
Enumeration of CPU access flags for frame buffers. For frame headers CPUACCESS is assumed to be TRUE..
typedef enum FrameQBufMgr_BufType_Tag FrameQBufMgr_BufType |
Denotes the type of buffer.
typedef enum FrameQBufMgr_AddrType_Tag FrameQBufMgr_AddrType |
Enumerations to indicate address types used for translation.
typedef enum FrameQBufMgr_Interface_Tag FrameQBufMgr_Interface |
Enumeration of FrameQBufMgr interface types.Denotes different implementation types.
Enumeration of FrameQBufMgr interface types.Denotes different implementation types.
Enumeration of FrameQBufMgr interface types.Denotes different implementation types.
typedef struct FrameQBufMgr_Config_Tag FrameQBufMgr_Config |
Structure defining module config parameters for the FrameQBufMgr module.
typedef struct FrameQBufMgr_CreateParams_Tag FrameQBufMgr_CreateParams |
Common parameters required to create FrameQBufMgr instance of any implementation.
This struct must be the first field of the implementation-specific params structure.
typedef struct FrameQBufMgr_CommonOpenParams_Tag FrameQBufMgr_CommonOpenParams |
Common parameters required to open a FrameQBufMgr instance of any implementation.
typedef struct FrameQBufMgr_Params FrameQBufMgr_Params |
Common parameters required to create FrameQBufMgr instance of any implementation.
This struct must be the first element of the implementation-specific create params structure.
typedef struct FrameQBufMgr_FrameBufParams_Tag FrameQBufMgr_FrameBufParams |
Frame buffer param structure.
typedef void(* FrameQBufMgr_NotifyFunc)(FrameQBufMgr_Handle, Ptr arg, UInt32) |
Prototype of the FrameQBufMgr call back function.
typedef struct FrameQBufMgr_NotifyParams_Tag FrameQBufMgr_NotifyParams |
Structure defining notification parameter structure.
Enumeration of CPU access flags for frame buffers. For frame headers CPUACCESS is assumed to be TRUE..
Enumerations to indicate address types used for translation.
Enumeration of FrameQBufMgr interface types.Denotes different implementation types.
Int32 FrameQBufMgr_setup | ( | FrameQBufMgr_Config * | cfg | ) |
Function to setup the FrameQBufMgr module.
This function sets up the FrameQBufMgr module. This function must be called before any other instance-level APIs can be invoked. Module-level configuration needs to be provided to this function. If the user wishes to change some specific config parameters, then FrameQBufMgr_getConfig can be called to get the configuration filled with the default values. After this, only the required configuration values can be changed. If the user does not wish to make any change in the default parameters, the application can simply call setup with NULL parameters. The default parameters would get automatically used.
cfg | Optional FrameQBufMgr module configuration. If provided as NULL, default configuration is used. |
FrameQBufMgr_Handle FrameQBufMgr_create | ( | Ptr | params | ) |
Function to create FrameQBufMgr instance.
This function create a new instance of FrameQBufMgr. It creates frameQBufMgr based on the params specific to implementation.
params | pointer to implementation specific params. |
Handle | Instance handle. |
NULL | Create failed. |
Int32 FrameQBufMgr_delete | ( | FrameQBufMgr_Handle * | pHandle | ) |
Function to delete FrameQBufMgr instance.
This function delets FrameQBufMgr instance that is created.
pHandle | Pointer to the created frameQ instance handle. |
FrameQBufMgr_S_SUCCESS | Delete successful. |
FrameQBufMgr_E_FAIL | Delete failed. |
FrameQBufMgr_E_INVALIDARG | Pointer to Handle passed is null. |
FrameQBufMgr_E_INVALIDARG | Handle passed is null. |
Int32 FrameQBufMgr_open | ( | FrameQBufMgr_Handle * | handlePtr, |
Ptr | openParams | ||
) |
Function to open the created FrameQBufMgr instance.
This function opens the FrameQBufMgr instance depending upon the open params passed to it.The instance must be created before opening it. Application is expected to pass the implementations specific open params for the openParams field.FrameQ_open internally calls this API to use the FrameQBufMgr instance to allocate frames ftom it.
handlePtr | Return parameter.Instance opened in given mode. |
openParams | Pointer to implementation specific open params. |
FrameQBufMgr_S_SUCCESS | open successful. |
FrameQBufMgr_E_INVALIDARG | Invalid parameter specified. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
FrameQBufMgr_E_MEMORY | Memory_alloc failed. |
FrameQBufMgr_E_ALLOC_MEMORY | Memory_alloc failed. |
FrameQBufMgr_E_FRAMEQBUFMGROPEN | FrameQBufMge instance open failed. |
FrameQBufMgr_E_OPEN_GATEMP | GateMP open failed. |
FrameQBufMgr_E_CLIENTN0TIFYMGR_OPEN | ClientNotifyMgr open failed. |
FrameQBufMgr_E_NOTFOUND | Instance not found in FrameQBufMgr Nameserver or instance is not crated at the shared address obtained internally. |
FrameQBufMgr_E_FAIL | Failed due to Both name is null and shared addr is null. |
FrameQBufMgr_E_INVALID_HDRINTERFACETYPE | Failed to create the Syslink memory manager for header buffers. |
FrameQBufMgr_E_INVALID_BUFINTERFACETYPE | Failed to create the Syslink memory manager for frame buffers. |
Int32 FrameQBufMgr_openByAddr | ( | FrameQBufMgr_Handle * | handlePtr, |
Ptr | openParams | ||
) |
Function to open the created FrameQBufMgr instance using the address provided in open params.
This function opens the FrameQBufMgr instance depending upon the open params passed to it.The instance must be created before opening it. Application is expected to pass the implementations specific open params for the openParams field.
handlePtr | Return parameter.Instance opened in given mode. |
openParams | Pointer to implementation specific open params. |
FrameQBufMgr_S_SUCCESS | open successful. |
FrameQBufMgr_E_INVALIDARG | Invalid parameter specified. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
FrameQBufMgr_E_MEMORY | Memory_alloc failed. |
FrameQBufMgr_E_ALLOC_MEMORY | Memory_alloc failed. |
FrameQBufMgr_E_FRAMEQBUFMGROPEN | FrameQBufMge instance open failed. |
FrameQBufMgr_E_OPEN_GATEMP | GateMP open failed. |
FrameQBufMgr_E_CLIENTN0TIFYMGR_OPEN | ClientNotifyMgr open failed. |
FrameQBufMgr_E_NOTFOUND | Instance not found in FrameQBufMgr Nameserver or instance is not crated at the shared address obtained internally. |
FrameQBufMgr_E_FAIL | Failed due to shared addr is null. |
FrameQBufMgr_E_INVALID_HDRINTERFACETYPE | Failed to create the Syslink memory manager for header buffers. |
FrameQBufMgr_E_INVALID_BUFINTERFACETYPE | Failed to create the Syslink memory manager for frame buffers. |
Int32 FrameQBufMgr_close | ( | FrameQBufMgr_Handle * | pHandle | ) |
Function to close the opened FrameQBufMgr instance.
This function closes FrameQBufMgr instance that is opened.
pHandle | Pointer to the opened FrameQBufMgr instance handle. |
FrameQBufMgr_S_SUCCESS | Close successful. |
FrameQBufMgr_E_INVALIDARG | Pointer to Handle passed is null. |
FrameQBufMgr_E_INVALIDARG | Handle passed is null. |
FrameQBufMgr_E_ACCESSDENIED | Invalid handle passed. |
Int32 FrameQBufMgr_alloc | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame * | frame | ||
) |
Function to allocate frame from free frame pool zero.
This function allocates a frame when called by FrameQBufMgr. from free Frame Pool zero.
handle | FrameQBufMgr handle. |
frame | Location to receive the allocated frame. |
FrameQBufMgr_S_SUCCESS | Successfully allocated frame. |
FrameQBufMgr_E_FAIL | Invalid buffer interface type. |
FrameQBufMgr_E_ALLOC_FRAME | Free frames are not available to allocate. |
FrameQBufMgr_E_INVALIDARG | framePtr paased is null. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_ACCESSDENIED | Provided handle can not allocate frames. Only writer can allocate frames. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_allocv | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | framePtr[], | ||
UInt32 | freeQId[], | ||
UInt8 * | numFrames | ||
) |
Function to allocate multiple frames from the FrameQbufMgr instance..
This function allocates frames from multiple free pools.This API allocates all the frames requested if available other wise returns failure.
handle | FrameQBufMgr handle. |
framePtr | Array to receive pointers to allocated frames.. |
freeQId | Array of free frame pool nos of the FrameQBufMgr from from which this API needs to allocate free frames . |
numFrames | Number of frames that needs to be allocated. |
FrameQBufMgr_S_SUCCESS | Successfully allocated frames. |
FrameQBufMgr_E_ALLOC_FRAME | Failed due to non availabilty of free frames in free frame pool. |
FrameQBufMgr_E_INVALIDARG | framePtr passed is null. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | freeQId passed is null. |
FrameQBufMgr_E_INVALIDARG | numFrames passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_free | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | frame | ||
) |
Function to free frame.
This function frees a frame.
handle | FrameQBufMgr instance handle. |
frame | Frame to be freed. |
FrameQBufMgr_S_SUCCESS | Successfully freed frame. |
FrameQBufMgr_E_FAIL | Free failed. |
FrameQBufMgr_E_INVALIDARG | frame passed is null. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_freev | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | framePtr[], | ||
UInt32 | numFrames | ||
) |
Function to free multiple frames to the FrameQBufMgr.
This function frees multiple frames to the FrameQBufMgr instance.
handle | FrameQBufMgr instance handle. |
framePtr | Array of frames to be freed. |
numFrames | Number of frames to free. The size of the framePtr should be at least numFrames. |
FrameQBufMgr_S_SUCCESS | Successfully freed frames. |
FrameQBufMgr_E_FAIL | Freev failed. |
FrameQBufMgr_E_INVALIDARG | framePtr passed is null. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Ptr FrameQBufMgr_add | ( | FrameQBufMgr_Handle | handle, |
UInt8 | freeQId | ||
) |
Function to add frame.
This function is to add free frames dynamically to the given pool id (freeQId). NOTE: API is not implemented.
Int32 FrameQBufMgr_remove | ( | FrameQBufMgr_Handle | handle, |
UInt8 | freeQId, | ||
FrameQBufMgr_Frame | framePtr | ||
) |
Function to remove frame.
This function is to remove the frames that is added dynamically. NOTE: API is not implemented.
Int32 FrameQBufMgr_dup | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | framePtr, | ||
FrameQBufMgr_Frame | dupedFramePtr[], | ||
UInt32 | numDupedFrames | ||
) |
Function to duplicate the frame.
This function duplicates the given frame and returns the duplicated frame. It internally allocates one Frame header buffer and copy the header info to the allocated header buffer and returns it. it also increments the reference count of the original frame by 1 as both original frame and duped frmae are pointing to the same frame buffers.
handle | FrameQBufMgr instance handle. |
framePtr | Original frame that needs to be duplicated. |
dupedFramePtr | Location to receive the duped frames. |
numDupedFrames | Number of duplicated frames required. |
FrameQBufMgr_S_SUCCESS | Successfully duped frame. |
FrameQBufMgr_E_FAIL | dup failed. |
FrameQBufMgr_E_INVALIDARG | framePtr passed is null. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | dupedFramePtr passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_dupv | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | framePtr[], | ||
FrameQBufMgr_Frame ** | dupedFramePtr, | ||
UInt32 | numDupedFrames, | ||
UInt32 | numFrames | ||
) |
Function to duplicate the multiple frames.
API to duplicate the given frames i.e it increments the corresponding frames's reference count.It internally allocates headers for the duped frames.API fails if it is not able to dup all the frames.
handle | Instance handle. |
framePtr | Array of frames to duplicated. |
dupedFramePtr | Location to receive duplicated frames. |
numDupedFrames | Number of duplicated frames required for each given frame. |
numFrames | Number of original frames that needs to be duplicated. |
FrameQBufMgr_S_SUCCESS | Successfully duped frame. |
FrameQBufMgr_E_FAIL | dup failed. |
FrameQBufMgr_E_INVALIDARG | framePtr passed is null. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | dupedFramePtr passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_registerNotifier | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_NotifyParams * | notifyParams | ||
) |
Function to register call back function for notification.
Function to Register notification with the instance. It internally registers notification with the individual free frame pools.If alloc on free frame pool 0 failed,Notification will be generated if free buffers in that pool becomes more than watermark.
handle | Instance handle. |
notifyParams | notify params. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | notifyParams passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
FrameQBufMgr_E_FAIL | Failed to register notification. |
Int32 FrameQBufMgr_unregisterNotifier | ( | FrameQBufMgr_Handle | handle | ) |
Function to unregister call back function.
Function to Register notification with the instance. It internally unregisters notification with the individual free frame pools.
handle | Instance handle. |
FrameQBufMgr_S_SUCCESS | Successfully duped frame. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | notifyParams passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
FrameQBufMgr_E_FAIL | Failed to register notification. |
Int32 FrameQBufMgr_writeBack | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | framePtr | ||
) |
Function to write back the frame.
Function to write back the contents of buffer .
handle | Instance handle. |
framePtr | frame to be written back to external memory. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | framePtr passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_writeBackBuf | ( | FrameQBufMgr_Handle | handle, |
Ptr | buf, | ||
UInt32 | flags | ||
) |
Write back the contents of buffer.
Function to write back the contents of buffer . Flags denotes whether it is header buffer or frame buffer..
handle | Instance handle. |
buf | Buffer to be written back. |
flags | Flags denotes whether buf is a header buffer or frame buffer. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | notifyParams passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_invalidate | ( | FrameQBufMgr_Handle | handle, |
FrameQBufMgr_Frame | framePtr | ||
) |
Function to invalidate frame.
Function to invalidate the contents of frame .
handle | Instance handle. |
framePtr | frame to be invalidated from external memory. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | framePtr passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_invalidateFrameBuf | ( | FrameQBufMgr_Handle | handle, |
Ptr | frameBuf, | ||
UInt32 | size, | ||
UInt8 | bufIndexInFrame | ||
) |
Function to invalidate frame buffer.
Function to invalidate the contents of frame buffer .
handle | Instance handle. |
frameBuf | framebuffer pointer. |
size | Size to be invalidated. |
bufIndexInFrame | index of the frame buffer in the frame to which the buffer bellongs to. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | frameBuf passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_writeBackFrameBuf | ( | FrameQBufMgr_Handle | handle, |
Ptr | frameBuf, | ||
UInt32 | size, | ||
UInt8 | bufIndexInFrame | ||
) |
Function to writeback frame buffer.
Function to writeback the contents of frame buffer .
handle | Instance handle. |
frameBuf | framebuffer pointer. |
size | Size to be writtenback. |
bufIndexInFrame | index of the frame buffer in the frame to which the given buffer bellongs to. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | frameBuf passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_invalidateHeaderBuf | ( | FrameQBufMgr_Handle | handle, |
Ptr | headerBuf | ||
) |
Invalidate the contents of frame header.
API treates the passed buffer as frame Header.
handle | Handle to the instance. |
headerBuf | frame header to be invalidated. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | headerBuf passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_writeBackHeaderBuf | ( | FrameQBufMgr_Handle | handle, |
Ptr | headerBuf | ||
) |
Write back the contents of frame header.
API treates the passed buffer as frame Header.
handle | Handle to the instance. |
headerBuf | frame header to be written back. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | headerBuf passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_translateAddr | ( | FrameQBufMgr_Handle | handle, |
Ptr * | dstAddr, | ||
FrameQBufMgr_AddrType | dstAddrType, | ||
Ptr | srcAddr, | ||
FrameQBufMgr_AddrType | srcAddrType, | ||
FrameQBufMgr_BufType | bufType | ||
) |
API to translate the given pointer to other address type.
handle | Handle to the instance. |
dstAddr | Location to receive the destination address (translated address). |
dstAddrType | address type to which the source address needs to be translated to. |
srcAddr | Source address. |
srcAddrType | Address type of the source address. |
bufType | buffer type. Denotes source address specified is frame header or frame buffer. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_FAIL | Invalid buffer type specified in bufType. |
FrameQBufMgr_E_FAIL | Translate failed in SysLinkMemMgr. bufType. |
FrameQBufMgr_E_INVALIDARG | handle passed is null. |
FrameQBufMgr_E_INVALIDARG | dstAddr passed is null. |
FrameQBufMgr_E_INVALIDARG | srcAddr passed is null. |
FrameQBufMgr_E_INVALIDSTATE | Module is not initialized. |
Int32 FrameQBufMgr_getConfig | ( | FrameQBufMgr_Config * | cfg | ) |
Function to initialize the config parameter structure with default values.
cfg | Parameter structure to return the config parameters. |
UInt32 FrameQBufMgr_getId | ( | FrameQBufMgr_Handle | handle | ) |
API to get the ID of the instance.
handle | Handle to the instance. |
id | Id of the instance. |
API to get the handle of the instance.
Id | id of the instance. |
pointer | handle of the instance. |
NULL | getHandle failed. |
Bool FrameQBufMgr_isCacheEnabledForHeaderBuf | ( | FrameQBufMgr_Handle | handle | ) |
Function to determine whether cache calls(writeback/invalidate) are enabled for frame headers.
handle | Instance handle. |
TRUE | if cache writeback and invalidate calls are enabled |
FALSE | if cache writeback and invalidate calls are disabled. |
Bool FrameQBufMgr_isCacheEnabledForFrameBuf | ( | FrameQBufMgr_Handle | handle, |
UInt8 | framebufIndex | ||
) |
Function to determine whether cache calls(writeback/invalidate) are enabled for frame headers.
handle | Instance handle. |
framebufIndex | frame buffer index in frame. |
TRUE | if cache writeback and invalidate calls are enabled |
FALSE | if cache writeback and invalidate calls are disabled. |
Int32 FrameQBufMgr_getNumFreeFrames | ( | FrameQBufMgr_Handle | handle, |
UInt32 * | numFreeFrames | ||
) |
Function to get the number of free frames availabel in pool 0.
handle | Instance handle. |
numFreeFrames | Out parameter.Denotes number of free frames available in queue 0. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
Int32 FrameQBufMgr_control | ( | FrameQBufMgr_Handle | handle, |
Int32 | cmd, | ||
Ptr | arg | ||
) |
Provides a hook to perform implementation dependent operation.
handle | Instance handle. |
cmd | Command to perform. |
arg | void * argument. |
FrameQBufMgr_S_SUCCESS | Operation successful. |
FrameQBufMgr_E_FAIL | API failed. |
Function to calcaulate the base frame header size when number of frames in a frame is given.
numFrameBufs | Number of Frame buffers. |
positive | value size of the base header size. |
Ptr FrameQBufMgr_getKnlHandle | ( | FrameQBufMgr_Handle | handle | ) |
Function to get the kernel space handle of the instance.
This API is valid only on HLOS side.
handle | Handle of the instance. |
pointer | Kernel space handle. |