B_ QuRT_ User_ Guide(33)

21.16 qurt_mem_map_static_query_64()

21.16.1 Function document

21.16.1.1 int int qurt_mem_map_static_query_64 ( qurt_addr_t ∗ vaddr, qurt_paddr- _64_t paddr_64, unsigned int page_size, qurt_mem_cache_mode_t cache_attribs, qurt_perm_t perm )

Determine whether a memory page is statically mapped . The following properties specify the page .64 Bit physical address , Page size , Cache mode , And memory permissions .
If the specified page is statically mapped ,vaddr Return the virtual address of the page . If the page is not statically mapped （ Or the specified page does not exist ）,vaddr return -1 As a virtual address value .
QuRT Memory mapping is defined in the system configuration file .
Related data types
qurt_addr_t
qurt_paddr_64_t
qurt_mem_cache_mode_t
qurt_perm_t

Parameters

Return value
QURT_EOK - The specified page is statically mapped ; stay vaddr Returns a virtual address in .QURT_EMEM - The specified page is not statically mapped ;vaddr Back in -1.QURT_EVAL - The specified page does not exist .
Dependencies
None.

21.17 qurt_mem_pool_add_pages()

21.17.1 Function document

21.17.1.1 int qurt_mem_pool_add_pages ( qurt_mem_pool_t pool, unsigned first_pageno, unsigned size_in_pages )

Adds a physical address range to the specified memory pool object . Be careful ： Only when there is root This operation can only be called with permission （guest-OS Pattern ）.
Related data types
qurt_mem_pool_t
Parameters

Return value
QURT_EOK - Page successfully added .
Dependencies
None.

21.18 qurt_mem_pool_attach()

21.18.1 Function document

21.18.1.1 int qurt_mem_pool_attach ( char ∗ name, qurt_mem_pool_t ∗ pool )

Initialize a memory pool object , To attach to a predefined memory pool in the system configuration file .
The memory pool object allocates memory regions to different Hexagon Physical memory of memory unit . They are specified in the memory region creation operation （ The first 21.42.1.1 section ）.
Be careful ：QuRT Memory pool objects are predefined qurt_mem_default_pool（ The first 21 section ）, Used in SMI Allocate memory area in memory . Only in non-standard memory units （ Such as TCM） When allocating a memory area in , The pool attachment operation is required .
Related data types
qurt_mem_pool_t
Parameters

Return value
QURT_EOK - Attach operation succeeded .
Dependencies
None.

21.19 qurt_mem_pool_attr_get()

21.19.1 Function document

21.19.1.1 int qurt_mem_pool_attr_get ( qurt_mem_pool_t pool, qurt_mem_pool_attr- _t∗attr )

Get memory pool properties .
Retrieve the memory pool configuration based on the memory pool handle , And fill the configuration value into the attribute structure .
Related data types
qurt_mem_pool_t
qurt_mem_pool_attr_t

Parameters

Return value
0 - success .
QURT_EINVALID - Corrupt handle ; The handle to the pool is invalid .
Dependencies

21.20 qurt_mem_pool_attr_get_addr()

21.20.1 Function document

21.20.1.1 int static int qurt_mem_pool_attr_get_addr ( qurt_mem_pool_attr_t ∗ attr, int range_id, qurt_addr_t ∗ addr )

Get the starting address of the specified memory pool range .
Related data types
qurt_mem_pool_attr_t
qurt_addr_t
Parameters

Return value
0 - success .
QURT_EINVALID - Range is invalid .
Dependencies
None.

21.21 qurt_mem_pool_is_available()

21.21.1 Function document

21.21.1.1 int qurt_mem_pool_is_available ( qurt_mem_pool_t pool, int page_count, qurt_mem_mapping_t mapping_type )

Check page_count Parameter indicates whether the number of pages can be allocated from the specified pool .
Related data types
qurt_mem_pool_attr_t
qurt_mem_mapping_t
Parameters

Return value
0 - success .
QURT_EINVALID - Mapping_type Invalid .
QURT_EMEM - Unable to allocate the specified page from the pool .

Dependencies
None.