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. More...

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 118 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.