Function: allocator_set_alloc_advise_func_to_desc

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product/Atlas A3 inference product

Atlas A2 training product/Atlas A2 inference product

Atlas training product

Atlas inference product

Atlas 200I/500 A2 inference product

Function

Sets the callback function for allocating memory blocks based on recommended addresses when the user-provided Allocator is used. This function is generally used in memory reuse scenario.

Prototype

  • C Prototype
    1
    aclError aclrtAllocatorSetAllocAdviseFuncToDesc(aclrtAllocatorDesc allocatorDesc, aclrtAllocatorAllocAdviseFunc func)
    
  • Python Function
    1
    ret = acl.rt.allocator_set_alloc_advise_func_to_desc(allocatorDesc, func)
    

Parameters

Parameter

Description

allocatorDesc

Int, pointer address of the allocator descriptor. Call acl.rt.allocator_create_desc to set the Allocator description in advance.

func

  • Callback function for allocating memory blocks based on the recommended addresses.

    Callback function definition:

    def allocator_alloc_advise_func(allocator, size, addr):
        pass

Return Value

Returned Value

Description

ret

Int, 0 on success; else, failure.