ddpi_module_get_owner operation

The ddpi_module_get_owner operation returns the owner of the Ddpi_Module object, which gives instance-specific information.

Description

If you want the list of all owners of all instances of this module, then use ddpi_module_get_all_owners.

Never deallocate the returned owner because ddpi_module_get_owner returns the actual owner, and not a copy.

Prototype

int ddpi_module_get_owner(             
  Ddpi_Module              module,        
  Ddpi_Module_Owner*       ret_owner,     
  Ddpi_Module_Owner_Type*  ret_owner_type,
  Ddpi_Error*              error);

Parameters

module: Input. This accepts the Ddpi_Module object.
ret_owner: Output. This returns the owner of the Ddpi_Module.
ret_owner_type: Output. This returns the owner type of the Ddpi_Module.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

Returned upon successful release of resources associated with the Ddpi_Info descriptor.

DW_DLV_NO_ENTRY

Never returned.

DW_DLV_ERROR

This value is returned if:

module is NULL
Ddpi_Info associated with module is NULL
ret_owner is NULL