Runtime Notifications

Enumerations
enum	hsa_status_t {   HSA_STATUS_SUCCESS = 0x0 , HSA_STATUS_INFO_BREAK = 0x1 , HSA_STATUS_ERROR = 0x1000 , HSA_STATUS_ERROR_INVALID_ARGUMENT = 0x1001 ,   HSA_STATUS_ERROR_INVALID_QUEUE_CREATION = 0x1002 , HSA_STATUS_ERROR_INVALID_ALLOCATION = 0x1003 , HSA_STATUS_ERROR_INVALID_AGENT = 0x1004 , HSA_STATUS_ERROR_INVALID_REGION = 0x1005 ,   HSA_STATUS_ERROR_INVALID_SIGNAL = 0x1006 , HSA_STATUS_ERROR_INVALID_QUEUE = 0x1007 , HSA_STATUS_ERROR_OUT_OF_RESOURCES = 0x1008 , HSA_STATUS_ERROR_INVALID_PACKET_FORMAT = 0x1009 ,   HSA_STATUS_ERROR_RESOURCE_FREE = 0x100A , HSA_STATUS_ERROR_NOT_INITIALIZED = 0x100B , HSA_STATUS_ERROR_REFCOUNT_OVERFLOW = 0x100C , HSA_STATUS_ERROR_INCOMPATIBLE_ARGUMENTS = 0x100D ,   HSA_STATUS_ERROR_INVALID_INDEX = 0x100E , HSA_STATUS_ERROR_INVALID_ISA = 0x100F , HSA_STATUS_ERROR_INVALID_ISA_NAME = 0x1017 , HSA_STATUS_ERROR_INVALID_CODE_OBJECT = 0x1010 ,   HSA_STATUS_ERROR_INVALID_EXECUTABLE = 0x1011 , HSA_STATUS_ERROR_FROZEN_EXECUTABLE = 0x1012 , HSA_STATUS_ERROR_INVALID_SYMBOL_NAME = 0x1013 , HSA_STATUS_ERROR_VARIABLE_ALREADY_DEFINED = 0x1014 ,   HSA_STATUS_ERROR_VARIABLE_UNDEFINED = 0x1015 , HSA_STATUS_ERROR_EXCEPTION = 0x1016 , HSA_STATUS_ERROR_INVALID_CODE_SYMBOL = 0x1018 , HSA_STATUS_ERROR_INVALID_EXECUTABLE_SYMBOL = 0x1019 ,   HSA_STATUS_ERROR_INVALID_FILE = 0x1020 , HSA_STATUS_ERROR_INVALID_CODE_OBJECT_READER = 0x1021 , HSA_STATUS_ERROR_INVALID_CACHE = 0x1022 , HSA_STATUS_ERROR_INVALID_WAVEFRONT = 0x1023 ,   HSA_STATUS_ERROR_INVALID_SIGNAL_GROUP = 0x1024 , HSA_STATUS_ERROR_INVALID_RUNTIME_STATE = 0x1025 }
	Status codes. More...

Functions
hsa_status_t HSA_API	hsa_status_string (hsa_status_t status, const char **status_string)
	Query additional information about a status code.

Detailed Description

Enumeration Type Documentation

hsa_status_t

enum hsa_status_t

Status codes.

Enumerator
HSA_STATUS_SUCCESS	The function has been executed successfully.
HSA_STATUS_INFO_BREAK	A traversal over a list of elements has been interrupted by the application before completing.
HSA_STATUS_ERROR	A generic error has occurred.
HSA_STATUS_ERROR_INVALID_ARGUMENT	One of the actual arguments does not meet a precondition stated in the documentation of the corresponding formal argument.
HSA_STATUS_ERROR_INVALID_QUEUE_CREATION	The requested queue creation is not valid.
HSA_STATUS_ERROR_INVALID_ALLOCATION	The requested allocation is not valid.
HSA_STATUS_ERROR_INVALID_AGENT	The agent is invalid.
HSA_STATUS_ERROR_INVALID_REGION	The memory region is invalid.
HSA_STATUS_ERROR_INVALID_SIGNAL	The signal is invalid.
HSA_STATUS_ERROR_INVALID_QUEUE	The queue is invalid.
HSA_STATUS_ERROR_OUT_OF_RESOURCES	The HSA runtime failed to allocate the necessary resources. This error may also occur when the HSA runtime needs to spawn threads or create internal OS-specific events.
HSA_STATUS_ERROR_INVALID_PACKET_FORMAT	The AQL packet is malformed.
HSA_STATUS_ERROR_RESOURCE_FREE	An error has been detected while releasing a resource.
HSA_STATUS_ERROR_NOT_INITIALIZED	An API other than hsa_init has been invoked while the reference count of the HSA runtime is 0.
HSA_STATUS_ERROR_REFCOUNT_OVERFLOW	The maximum reference count for the object has been reached.
HSA_STATUS_ERROR_INCOMPATIBLE_ARGUMENTS	The arguments passed to a functions are not compatible.
HSA_STATUS_ERROR_INVALID_INDEX	The index is invalid.
HSA_STATUS_ERROR_INVALID_ISA	The instruction set architecture is invalid.
HSA_STATUS_ERROR_INVALID_ISA_NAME	The instruction set architecture name is invalid.
HSA_STATUS_ERROR_INVALID_CODE_OBJECT	The code object is invalid.
HSA_STATUS_ERROR_INVALID_EXECUTABLE	The executable is invalid.
HSA_STATUS_ERROR_FROZEN_EXECUTABLE	The executable is frozen.
HSA_STATUS_ERROR_INVALID_SYMBOL_NAME	There is no symbol with the given name.
HSA_STATUS_ERROR_VARIABLE_ALREADY_DEFINED	The variable is already defined.
HSA_STATUS_ERROR_VARIABLE_UNDEFINED	The variable is undefined.
HSA_STATUS_ERROR_EXCEPTION	An HSAIL operation resulted in a hardware exception.
HSA_STATUS_ERROR_INVALID_CODE_SYMBOL	The code object symbol is invalid.
HSA_STATUS_ERROR_INVALID_EXECUTABLE_SYMBOL	The executable symbol is invalid.
HSA_STATUS_ERROR_INVALID_FILE	The file descriptor is invalid.
HSA_STATUS_ERROR_INVALID_CODE_OBJECT_READER	The code object reader is invalid.
HSA_STATUS_ERROR_INVALID_CACHE	The cache is invalid.
HSA_STATUS_ERROR_INVALID_WAVEFRONT	The wavefront is invalid.
HSA_STATUS_ERROR_INVALID_SIGNAL_GROUP	The signal group is invalid.
HSA_STATUS_ERROR_INVALID_RUNTIME_STATE	The HSA runtime is not in the configuration state.

Definition at line 121 of file hsa.h.

Function Documentation

hsa_status_string()

hsa_status_t HSA_API hsa_status_string	(	hsa_status_t	status,
		const char **	status_string )

Query additional information about a status code.

Parameters

[in]	status	Status code.
[out]	status_string	A NUL-terminated string that describes the error status.

Return values

HSA_STATUS_SUCCESS	The function has been executed successfully.
HSA_STATUS_ERROR_NOT_INITIALIZED	The HSA runtime has not been initialized.
HSA_STATUS_ERROR_INVALID_ARGUMENT	status is an invalid status code, or status_string is NULL.